Installing the Datapack
Craftify is a standard Minecraft datapack. It requires no plugins, no mods, and no external software. It works on vanilla, Bukkit, Spigot, and Paper servers.
Requirements
- Minecraft Java Edition (Pack Format 48 — Minecraft 1.21+)
- A world already generated (the
datapacks/folder must exist) - Operator level 2 or higher to run functions in-game
Download
Download the latest release from the Craftify GitHub releases page. Use the most recent stable release unless you need an older version.
Folder Placement
Place the datapack folder inside the datapacks directory of your world save:
pack.mcmeta file must be directly inside the Craftify/ folder. Double-nesting is the most common installation mistake.Show the file system / FTP view with the Craftify folder placed correctly inside world/datapacks/. The pack.mcmeta file should be visible inside the Craftify folder.
Reloading & Verifying
After placing the datapack, load it using one of these methods:
If the server is already running
Reloads all datapacks without restarting the server.
If starting fresh
Start the server normally. Datapacks in the datapacks/ folder load automatically on world load.
Verify the datapack is active
You should see [craftify] listed as enabled. If it appears under "available" but not "enabled", run:
Show the chat output of /datapack list with Craftify listed and enabled (green).
Setup Steps
After verifying the datapack is loaded, run the setup function once:
The setup function:
- Configures relevant gamerules
- Initialises the warp data storage used to persist warp points
- Registers the pulse (tick) function for the bee counter and dragon announcement
- Sets up the first-join advancement trigger for the welcome pack
/function craftify:setup once after every fresh installation, and again if you reset the world or move the datapack to a new world.Admin Features
Dragon Death Announcement
When a player kills the Ender Dragon, a server-wide message is broadcast to all online players automatically via the pulse function — no configuration needed.
X-Ray Diamond Warning
The first time a player picks up diamonds, a configurable warning message is displayed as a gentle reminder of server rules. Fires once per player.
Bee Counter
When a player breaks a bee nest or beehive, the number of bees currently inside is shown in chat, preventing accidental colony destruction.
Welcome Function
The craftify:welcome function is triggered automatically on first join via an advancement. To manually give the welcome pack to a specific player:
Warp Management
Warps are stored in Minecraft's command storage (craftify:warps) and accessed via the warp book item.
Creating a Warp Point
Stand at the desired warp destination, then run:
Show an admin running the warp creation function at a location. The confirmation message in chat should be visible.
Removing a Warp Point
Run /function craftify:warp/list first to see the names of registered warps.
Listing Warps
Outputs all registered warp points and their coordinates to admin chat / console.
Restart Persistence
Warp data does not persist across server restarts by default. To ensure warps survive restarts:
- Manual re-setup — run warp creation functions again after each restart.
- Startup script — use CommandHelper or a similar tool to auto-run warp registration on world load.
- Check release notes — newer Craftify releases may address persistence.
Permissions
| Action | Required Level | Notes |
|---|---|---|
| Use warp book / random warp | All players (level 0) | No operator permission needed |
Run /function craftify:* | Operator level 2+ | Required for setup and warp management |
| Create / remove warp points | Operator level 2+ | Admin-only action |
Run /function craftify:setup | Operator level 2+ | Run once on installation |
| Enable / disable the datapack | Operator level 3+ | Via /datapack commands |
| Install / update datapack files | Filesystem access | FTP / console access required |
/function to specific roles. By default all /function commands require operator level 2.Maintenance & Updates
Updating the Datapack
- Download the new release from GitHub.
- Stop the server or wait for a low-traffic period.
- Replace the old
Craftify/folder with the new version. - Start the server (or run
/reload). - Re-run
/function craftify:setupif the update notes recommend it. - Verify with
/datapack listand test key features.
Disabling Specific Features
Individual features cannot be toggled without editing the datapack files directly. Remove or rename the relevant file in data/craftify/ or data/minecraft/. Always keep a backup before editing.
Troubleshooting
| Problem | Likely Cause | Fix |
|---|---|---|
| Recipes not working | Datapack not loaded or /reload not run after placement | Run /reload in-game or restart the server. Confirm with /datapack list. |
| Welcome pack not received | Advancement already triggered, or setup not run | Run craftify:setup and ensure the advancement for first-join is not locked. |
| Warp points missing after restart | Warp registry not persisted via storage before shutdown | Re-run warp creation functions after each restart, or configure auto-reload via craftify:setup. |
| Dragon egg not dropping | Loot table override not applied | Verify datapack is listed and enabled. Run /reload. |
| Player heads not dropping | PvP disabled, or loot table conflict with another datapack | Ensure PvP is enabled and no conflicting datapacks override the player loot table. |
| Bee count not showing on break | Function tag not loading correctly | Run /reload and check for errors in the server console. Ensure no other datapack overrides the tick function tag. |
| Chainmail / Elytra recipe not appearing | Recipe advancement not yet unlocked, or recipe file missing | Check recipe files are present. Unlock the recipe advancement if needed. |
| Datapack not listed in /datapack list | Incorrect folder placement or missing pack.mcmeta | Confirm the datapack folder (with pack.mcmeta inside) is placed directly in world/datapacks/. Do not nest folders. |
/reload. Craftify logs errors there if any function or loot table files fail to parse.FAQ
Does Craftify work on Paper / Spigot?
Yes. Craftify is a pure vanilla datapack. It works on Paper, Spigot, and plain vanilla Java servers.
Can I use Craftify alongside other datapacks?
Generally yes, but watch for conflicts. Any datapack that overrides the same loot tables (e.g. minecraft:entities/ender_dragon) may conflict. Test thoroughly before deploying on a live server.
How do I reset a player's first-join status?
Revoke the relevant advancement:
The next time they join, the welcome pack trigger will fire again.
Can I change the items in the welcome pack?
Yes — edit data/craftify/functions/welcome.mcfunction. Maintain valid syntax and test changes on a dev server first.
How do I give a player the warp book directly?
Use the craftify:warp/book loot table, or run the appropriate give command as an admin targeting the player.