A D&D-themed Fabric mod — land ownership, coins, quests, mines, hazards and more.
⬇ Download mod v1.1.331.21.11, Fabric Loader, Java 21.
No extra mods are required — all dependencies are bundled in the JAR.
ashenfall-1.1.33-client.jar.
mods subfolder.
m8jmodstk10va-*.jar file from that folder
before copying in the new one.
ashenfall-1.1.33-client.jar from your Downloads folder into the
mods folder.
Available to all players.
/coins| Command | Description |
|---|---|
/coins balance | Check your current coin balance. |
/coins pay <player> <amount> | Send coins to another player. |
/coins drop <amount|all> | Drop coins on the ground as a collectible pile. |
/land| Command | Description |
|---|---|
/land here | Show the name and type of the land section you're standing in. |
/land buy <section> | Purchase a land section that is listed for sale. |
/land sell <section> <player> <price> | Offer ownership of your land to another player for a set price. |
/land accept | Accept a pending land sale offer directed at you. |
/land decline | Decline a pending land sale offer. |
Adventure-mode interaction rule. While in adventure mode you can only use anvils, doors, and trapdoors inside land you personally own. Everywhere else — including dungeons, settlements, and unclaimed wilderness — those blocks are locked. The rule applies to everyone in adventure mode, ops included; only players in creative mode are unaffected. (Containers follow a similar rule; decorated pots are always read-only in adventure mode.)
A server-specific XP and level system, completely separate from Minecraft's enchanting XP.
/reputation| Command | Description |
|---|---|
/reputation me | Show your reputation with every NPC and settlement you've interacted with, plus your current tier in each. |
Tiers (per NPC and per settlement):
Stranger (≥ 0)
· Acquainted (≥ 100)
· Trusted (≥ 300)
· Honored (≥ 600)
· Revered (≥ 1000).
Adventure-mode rule. Reputation and XP rewards only apply while you are in adventure mode. Hitting or killing villagers / iron golems / animals inside a settlement costs you settlement reputation (player-tamed pets are exempt). Reputation can go negative; the floor is -1000. Coin rewards are unaffected by game mode.
Some NPCs are merchants. Talk to one and pick the "Show me your wares" (or similar) option to open their shop. The shop has two tabs:
+ button won't let you queue more than you own.Some items only unlock once you've earned enough reputation with the merchant or their settlement — locked items appear greyed out until you qualify. There's no command; shops are always reached by talking to the NPC, and the screen closes if you walk away.
Some merchants also sell mounts (shown with a saddle icon). Buying one adds it to your collection of owned mounts rather than to your bag — you can only own one of each, and an already-owned mount shows as "Already owned". If a merchant offers a buy-back price you can sell a mount you own on the Sell tab.
Manage your mounts from the parchment on the right side of your inventory: it lists every mount you own (scroll if the list is long). Click one to make it your active mount (the active one is marked ◆; click it again to deactivate). Press the Recall Mount key (default R, rebindable under Options → Controls → Gameplay) anywhere to summon your active mount to your side — recalling always destroys any previously-summoned copy, so there's only ever one of your mount in the world. Your mount is yours alone: other players can't ride or harm it, and it vanishes when you log out (recall it again next time).
Some walls, floors and ceilings are magic: speak the right words at them and they slide, sink, fade or crumble away — and later close again. When you come near one you'll hear a soft chime.
Press the Open Spellbook key (default C for conjure, rebindable under Options → Controls → Gameplay) anywhere, while in adventure mode. Look at the surface before you open the book — you can't turn while it's open. Type the incantation and press Cast (or Enter); the surface must be within 16 blocks and not hidden behind anything else.
Aperio 7 = aperio 7).All admin commands require the executor to be in Creative mode.
/tk10va reloadEdits to the server's config files — from the web-admin or by hand — go live by themselves within a few seconds, even while the server is paused: land, coin piles, fishing waters, quests, dialogues, merchants, mounts, collectibles, magic surfaces, the five dungeon files, loot tables, coins.json and reputation_losses.json. There is nothing to reload by hand after an edit.
| Command | Description |
|---|---|
/tk10va reload | Re-read all of those files right now, whether or not they look changed, and list what each one loaded — or which could not be read (that one keeps what it had, details in the server log). Use it when an edit does not seem to arrive (for example a file restored from a backup with its old timestamp and size) or to see at a glance what is loaded. Permission tk10va.reload.admin; also works from the server console and RCON. |
/landSections can also be managed in the web-admin's Land page: a map per world, renaming, type, owners, price and parent, polygon corners and Y ranges, new rectangles, deletes, and merging. The game picks up those edits within a few seconds; a section deleted there gets the same clean-up as /land delete. Fill sections keep the shape /land fill gave them. No section of any type (fishing waters included) can be made in the resource world — it is wiped every day.
| Command | Description |
|---|---|
/land select |
Puts a land selection stick in your hand (the one you already have, if any — it is moved to your selected hotbar slot). Right-click a block to set corner 1, Left-click to set corner 2. |
/land create <name> <type> |
Create a rectangular land section from the two selected corners. Types: landmark settlement dungeon
house quest_area mine territory portal fishingportal — entrance to the resource world: walking in sends players there while a session is open (see Resource World below).fishing — a fishing water with its own catches (see Fishing Waters below). It is secret and lies on top of the land around it.
|
/land fill <name> <type> [sealed] |
Create a section by flood-filling from your position through passable blocks (air, fluids, doors, trapdoors, iron bars, glass panes, copper grates, spider webs — cap 2 000 000 blocks). Useful for irregular rooms and caves.
sealed: doors, trapdoors, iron bars, glass panes and copper grates count as walls — the fill stops at doorways and windows, so you can claim a single room without it leaking into the corridor (also the fix when a room's only openings are doors and the plain fill overflows). Blocks with no collision (air, fluids, plants, torches, cobwebs) are still passed through.
Footprint: the section's footprint is the exact set of 3D cells visited by the flood-fill plus a one-block expansion in all six directions (so the immediate floor, ceiling, and wall blocks are claimed for adventure-mode protection). Non-convex shapes don't bulge outward to claim adjacent open terrain, and walking on top of any ceiling — even a low side tunnel inside a larger dungeon — falls outside the section. Visualiser: the filled area is temporarily marked with ochre frog-light blocks for 2 minutes, then automatically restored (even after a server restart). On success the interior is highlighted so you can verify the captured area. On overflow (not fully enclosed) up to 100k frontier positions are marked showing the leak; fly in spectator mode to locate the gap. |
/land transfer <section> <player> |
Transfer full ownership of a section to another player, immediately removing all previous owners. All affected players are notified. |
/land set <section> purchasable <true|false> |
Mark a section as available (or unavailable) for player purchase. |
/land set <section> price <amount> |
Set the coin price for purchasing a section. |
/land delete <section> |
Permanently delete a land section. |
/land merge <keep> <absorb> [confirm] |
Merge two sections that overlap or touch (share a block face) into one. Without confirm it only previews the result; add confirm to do it. They must be in the same world, of the same type, and neither inside the other (parent/child). <keep> keeps its name, id, type, price and parent; <absorb> is removed and everything that referred to it moves over: its dungeon data (zones/puzzles that clash by name are renamed, e.g. z001 → z007, boss → boss_2; a second end zone's tiles join the kept one), quests, dialogues and merchant gates, settlement reputation (each player keeps the higher of the two scores), discovered lands, and child sections. Owners are combined. Two polygon sections of the same height become one polygon; other shapes become exact block footprints. Dungeons merge only while both are empty. Also available as the Merge button in the web-admin's Land page. |
/land info <section> |
Display full details: ID, world, footprint (polygon vertices, or XZ column count for fill-created sections), Y-range, price, owners, parent section. |
/land list |
List all defined land sections. |
/land shimmer on [section]/land shimmer off [section] |
Toggle the translucent boundary glow on all sections or a specific one. Useful when setting up land areas. |
/coinsEvery coin pile placed with /coins add is listed — and can be edited on a map — in the web-admin's Coins page: amount (fixed or random), respawn delay, delete. Changes count the next time a pile is collected; a deleted pile disappears and never respawns. Piles placed earlier appear there once their chunk has been loaded.
| Command | Description |
|---|---|
/coins balance <player> | Check another player's balance. |
/coins give <player> <amount> | Add coins to a player's balance. |
/coins take <player> <amount> | Remove coins from a player's balance. |
/coins add <amount> [delaySeconds] | Spawn a coin pile entity at your position. If delaySeconds is given, the pile respawns automatically after that many seconds. |
/coins add random <min> <max> [delaySeconds] | Spawn a coin pile with a random amount rolled from the inclusive [min, max] range. Values above the pile cap (40) are clamped silently. The rolled amount is not revealed, and a fresh value is rolled on every respawn. |
/coins remove | Remove the coin pile you are looking at, its respawn timer and its entry on the web-admin's Coins page. |
/fishingAll subcommands require permission tk10va.fishing.admin + op 4 + Creative. A fishing water is a land section of type fishing — a lake, or part of one — made like any other section: /land select + /land create <name> fishing, /land fill <name> fishing, or + Rectangle on the web-admin's Land page (where its outline and Y range can be edited too). It has its own list of things that can be fished up there: any minecraft: or tk10va: item, each with a chance per cast (0.1–100 %) and a count range (1–64). The chances together may be at most 100 %; whatever they leave over is the normal vanilla catch (fish, junk, treasure). Example: 30 % minecraft:gold_nugget + 10 % tk10va:coin → 60 % of casts are vanilla. The catches are edited only on the web-admin's Fishing page and count from the next cast.
How it behaves: what counts is where the bobber lands, not where the player stands — casting from the shore into the water gets its catches. Where fishing waters overlap the smallest wins, so a cove inside a lake can have its own list. A fishing water never replaces the land it lies in: a pond in a house or a settlement changes nothing about building, reputation or titles there. Fishing waters are secret: entering one shows nothing, and only creative players are sent them (shimmer, tab-completion). Luck of the Sea only improves the vanilla part; Lure, XP and rod wear are vanilla. The port key and quest items can never be caught. Deleting the section (/land delete, or the Land page) or changing its type deletes its catches; merging two fishing waters keeps the kept one's catches (or the other's, if it had none). Catches are stored in config/tk10va/fishing_waters.json.
| Command | Description |
|---|---|
/fishing info | The catches of the fishing water you stand in, with the vanilla remainder and any warnings — like the /dungeon commands, it acts on the section you stand in. |
/fishing list | Every fishing water in this world, nearest first: number of catches, their total %, distance. |
/land shimmer on|off <name> | Show a fishing water as blue walls (only creative players see them). While it shimmers, a creative player walking in gets its name as a title. |
/dungeon zoneAll subcommands require op level 4 (or the tk10va.dungeon.admin permission) and Creative mode.
Zones and new spawn points are placed in-game. In the web-admin (Dungeons page, Mob zones tab) you can rename zones, change radii, and add, edit or remove mobs at a point the zone already has: its trigger point or an existing spawn point. There is also a bulk add that drops a mob at the trigger point of every listed zone.
| Command | Description |
|---|---|
/dungeon zone add <radius> [name] |
Create a proximity-triggered spawn zone at the spot you are looking at, in the dungeon you stand in, and select it. Without a name it is auto-named z001, z002, … (one past the highest existing number). A given name must be unique within the dungeon: letters, digits and _ - . +, at most 32 characters. radius is the Euclidean trigger distance in blocks. |
/dungeon zone select [zone-name] |
Select a zone, so the commands below can leave out its name. Without a name it selects the zone whose trigger point is nearest to you. The selection is per admin and is forgotten on logout. |
/dungeon zone addmob <entity-type> [count] |
Add a mob spawn entry to the selected zone, at the spot you are looking at. count is 1–20 (default 1). Entity types are tab-completed and must exist. Typical flow: add 4, then look and addmob minecraft:zombie 2 as many times as needed, then the next add. |
/dungeon zone addmob to <zone-name> <entity-type> [count] |
Same, for a named zone (which then becomes selected). |
/dungeon zone removemob |
Remove the selected zone's mob entry nearest to the spot you are looking at. |
/dungeon zone rename <zone-name> <new-name> |
Rename a zone in the dungeon you stand in. Same name rules as add. |
/dungeon zone list |
List all zones for the dungeon you are standing in, showing each zone's name, trigger position, radius, and number of mob entries. The selected zone is marked ▶. For any other dungeon, use the web-admin's Dungeons page. |
/dungeon zone remove <zone-name> |
Permanently delete a zone from the dungeon you are standing in. Zone names are tab-completable. |
/dungeon zone test [zone-name] |
Instantly spawn all mobs for the named (or selected) zone without triggering its activation flag — useful for testing placement in creative mode. |
/dungeon zone show |
For 20 seconds, show the zones of the dungeon you stand in (within 48 blocks) in particles, to you only: a ring for each trigger radius (green = selected), a short column at each trigger point, a flame at each mob spawn point. The nearest zone's name is shown on the action bar — use it to match zones in the web-admin to places in the world. |
/dungeon coinsRegister persistent coin piles inside a dungeon. Each pile respawns automatically 5 seconds after the dungeon resets (when all players leave or die). Amounts (fixed or random, at most 40) can also be changed, and piles deleted, in the web-admin's Dungeons page (Coins tab). A pile pays out its entry's current amount when collected (a random one rolls then), so an edit counts immediately — even for a pile already lying in the dungeon.
| Command | Description |
|---|---|
/dungeon coins add <amount> |
Register a coin pile at your current position in the dungeon you are standing in. The pile spawns immediately and will respawn after every dungeon reset. amount is the number of coins in the pile. |
/dungeon coins add random <min> <max> |
Register a coin pile that rolls a fresh random amount from the inclusive [min, max] range on every spawn — including after each dungeon reset. Players raiding the same dungeon repeatedly see a different payout each run. |
/dungeon coins list |
List all registered coin piles for the dungeon you are standing in, showing each pile's ID, coordinates, and coin amount (or the random range for ranged piles). For any other dungeon, use the web-admin's Dungeons page. |
/dungeon coins remove |
Remove the coin pile registration nearest to your position (within the current dungeon). The live entity is also removed immediately. |
/dungeon puzzleDefine interactive puzzle areas inside a dungeon. When all targets are activated the reward chest behind the iron bars becomes accessible and a custom message is displayed on-screen in purple to every player in the dungeon. Long messages wrap automatically — all lines appear simultaneously with a fade-in/stay/fade-out animation. Bars and block states are automatically restored when the dungeon resets.
Puzzle types: CANDLES — light every candle in the area |
LEVERS — flip every lever to ON |
HEADS — right-click every custom head block in the area
A puzzle's id, type and completion message can also be changed, and puzzles deleted, in the web-admin's Dungeons page (Puzzles tab). Its box and iron bars are set in-game only.
/dungeon puzzle pos1./dungeon puzzle pos2./dungeon puzzle area define <id> <type> <message> to create the area./dungeon puzzle bar add <id>.| Command | Description |
|---|---|
/dungeon puzzle pos1 |
Mark the first bounding-box corner of the puzzle area (the block you are looking at). |
/dungeon puzzle pos2 |
Mark the second bounding-box corner. |
/dungeon puzzle area define <id> <type> <message> |
Create a puzzle area from the two selected corners in the dungeon you are standing in.id — unique name (e.g. puzzle1).type — CANDLES, LEVERS, or HEADS.message — completion text shown to all players in purple. Can be long — text wraps automatically and all lines display at once.
|
/dungeon puzzle area remove <id> |
Permanently delete a puzzle area definition. |
/dungeon puzzle area list |
List all puzzle areas defined in the dungeon you are standing in. |
/dungeon puzzle bar add <id> |
Register the block you are looking at as an iron-bar position for the puzzle. Repeat for each bar block. |
/dungeon puzzle bar remove <id> |
Remove the bar position nearest to your current location from the puzzle's list. |
/dungeon puzzle solved <id> |
Manually mark a puzzle as solved — removes bars and triggers the completion message. Safe to call from a command block. |
/dungeon puzzle reset <id> |
Reset a single puzzle mid-run: restores bars and clears progress for that puzzle only. |
/dungeon chestRegister reward chests inside a dungeon with a vanilla loot table. On every dungeon reset each registered chest is cleared and its loot table is re-seeded so the next player to open it gets fresh randomised contents. A chest's loot table can also be changed (picked from the mod's and vanilla's chest tables), and chests removed, in the web-admin's Dungeons page (Chests tab); an unopened chest uses the new table the next time it is opened. Chests are filled once per run — leaving and re-entering while others are still inside does not refill an opened chest.
| Command | Description |
|---|---|
/dungeon chest add <loot-table> |
Register the chest you are looking at in the current dungeon with the given loot table: one of the server's own tk10va:… tables or a vanilla minecraft:chests/… one (e.g. minecraft:chests/simple_dungeon). Both are tab-completed; an unknown id is refused. The chest is cleared and re-seeded once per run.The tk10va: tables are server config — config/tk10va/loot_tables/<name>.json, used as tk10va:<name> — created and edited in the web-admin's Loot Tables tab (vanilla loot-table format; a form for weighted items, counts and enchantments, raw JSON for anything else). Edits count the next time an unopened chest is opened. A new server starts with these defaults:
|
/dungeon chest list |
List all registered chests for the dungeon you are standing in, showing each chest's loot table and coordinates. For any other dungeon, use the web-admin's Dungeons page. |
/dungeon chest remove |
Unregister the chest nearest to your position in the current dungeon. The chest itself is not affected — only the registration is removed. |
/dungeon endzoneMark a set of contiguous floor tiles at the very end of a dungeon. When a player steps on any registered tile, they earn XP — once per dungeon run. The triggered state clears when the dungeon empties and resets. The XP reward can also be changed, and the end zone deleted, in the web-admin's Dungeons page (End zone tab).
| Command | Description |
|---|---|
/dungeon endzone set <xp> |
Create (or replace) the end zone for the current dungeon. The floor tile you are looking at becomes the first tile. The <xp> value is awarded to each player who steps on the zone for the first time during a run. |
/dungeon endzone tile add |
Add the floor tile you are looking at to the end zone. The new tile must be face-adjacent (touching) to at least one already-registered tile — tiles must form a single connected group. |
/dungeon endzone tile remove |
Remove the registered end-zone tile nearest to your position. |
/dungeon endzone remove |
Delete the entire end zone for the current dungeon. |
/dungeon endzone list |
Show all registered tiles and the XP reward for the current dungeon's end zone. |
/dungeon reset-dungeonForces a full dungeon reset from the admin side without waiting for all players to leave. (The dungeon files reload by themselves — see /tk10va reload.) Changes count immediately: a coin pile pays out its entry's current amount when collected, an unopened chest uses its entry's current loot table when opened, and end-zone XP is read when stepped on. A chest already opened this run keeps its contents until the next reset.
| Command | Description |
|---|---|
/dungeon reset-dungeon |
Immediately triggers a full reset of the dungeon you are standing in: removes all mobs, restores pots and puzzle blocks, restores iron bars, clears puzzle progress, re-seeds all registered reward chests, and respawns dungeon coin piles after 5 seconds. Useful for testing without needing to leave the dungeon. |
/npcAll subcommands require permission tk10va.npc.admin + creative mode. Two NPC kinds coexist:
/npc bind. Skin is the villager's own; AI is vanilla villager behaviour.NpcEntity with a player-model skin loaded from the resource pack and a configurable movement mode.NPCs are created in-game, but can then be managed on a map in the web-admin's NPCs page: rename, change a custom NPC's skin and behaviour (stationary, wander radius around a home, or an ordered patrol route — every point can be picked on the map), move, or delete. The map shows each NPC where it is now (live while its chunk is loaded), its wander area and patrol route, over the land sections, coin piles and — optionally — online players. A loaded NPC changes within a few seconds; an unloaded one when its chunk next loads (the game loads it for a couple of minutes to get there sooner). An edit is refused if the NPC was changed in-game since the page loaded it. Changes are recorded in the admin log.
The NPC list (config/tk10va/npcs.json) belongs to the server's config folder, not to a world: a world only has the NPCs spawned in it. An NPC whose spot is loaded but which is not there is shown in red as not in this world on the NPCs page; re-create it with /npc spawn or delete its record. The server log explains what it finds — search it for [NpcHealth] (NPCs loaded, missing, removed and by what, stray or duplicate NPC entities). /kill removes an NPC entity (no other damage does) — use it for a stray one with no record.
Villager binding commands
| Command | Description |
|---|---|
/npc bind <name> | Bind the looked-at villager as an NPC. Rejects when <name> is already taken — re-run with /npc bind <name> confirm to move the binding to the new villager. |
/npc bind <name> confirm | Confirmed move of an existing binding — preserves UUID (all quest/dialogue/rep references survive). |
/npc unbind <name> | Remove a villager binding. Works whether the entity is loaded or not. |
/npc rebind <newName> | Rename the looked-at villager NPC. UUID is unchanged. |
Custom NPC entity commands
| Command | Description |
|---|---|
/npc spawn <name> <texture> [stationary|wander <radius>|patrol] | Spawn a custom NPC at your feet. <texture> is the bare skin filename without extension (e.g. aldric for assets/tk10va/textures/entity/npc/aldric.png). Tab-complete shows all available skins. Default behavior is stationary. |
/npc remove <name> | Kill the custom NPC entity and remove its registry entry. If its chunk is not loaded, the entity is removed the next time it loads. Use /npc unbind for villager-kind NPCs. |
/npc texture <name> <texture> | Swap the skin on a live custom NPC. <texture> is the bare skin filename (e.g. aldric). Tab-complete shows available skins. Change takes effect immediately. |
/npc behavior <name> stationary | Set the NPC to stand still and look at nearby players. |
/npc behavior <name> wander <radius> | Set the NPC to wander within <radius> blocks of its current position (radius ≥ 1). |
/npc behavior <name> patrol | Switch to patrol mode with an empty waypoint list. Add waypoints with /npc waypoint <name> add. |
/npc waypoint <name> add | Append your current block position as the next patrol waypoint. NPC must already be in patrol mode. |
/npc waypoint <name> clear | Remove all patrol waypoints for the NPC (it will stand still until new waypoints are added). |
/npc namevisible <name> show | Make the NPC's name tag always visible, floating above its head. |
/npc namevisible <name> hide | Hide the NPC's name tag. The name is still stored internally; restore it with show. |
Shared commands
| Command | Description |
|---|---|
/npc inspect | Print the UUID, kind, and display name of the looked-at villager or custom NPC entity (or "unbound"). |
/npc list | List every registered NPC (both kinds) with kind tag and last-known position. |
Name rules. Case-sensitive; letters / digits / spaces / hyphens / underscores. Reserved literals (cannot be used as NPC names): bind, unbind, rebind, inspect, list, route, reload, test, validate, confirm, spawn, remove, texture, behavior, waypoint, namevisible.
Name tag. Custom NPCs spawn with their registry display name shown as a floating name tag (show by default). Use /npc namevisible <name> hide to suppress it for background characters. The visibility state persists across server restarts via the entity's own NBT.
Skin workflow. Place a 64×64 PNG in src/main/resources/assets/tk10va/textures/entity/npc/, run ./gradlew buildResourcePack, deploy, restart the server. The filename without the .png extension is the value you pass to /npc spawn and /npc texture (e.g. file aldric.png → command arg aldric). A grey placeholder (default) is always available as a fallback.
Immortality. All bound NPCs (both kinds) cannot be killed. Attacking a custom NPC entity costs NPC reputation equal to a kill (50 by default) when the attacker is in adventure mode.
/reputationAll admin variants require permission tk10va.reputation.admin. The add subcommand bypasses the adventure-mode gate (admin override path); event-driven rep changes still respect the gate. <player> accepts offline players (game-profile lookup).
| Command | Description |
|---|---|
/reputation show <player> | Dump every NPC and settlement reputation entry for the given player. |
/reputation settlement <settlement> <player> | Show the player's score and tier for one settlement. <settlement> is a SETTLEMENT-typed land display name. |
/reputation npc <npcId> <player> | Show the player's score and tier with one NPC. Until the NPC registry ships, <npcId> must be a raw UUID. |
/reputation add npc <npcId> <player> <amount> | Adjust an NPC reputation directly (clamped at -1000). Bypasses the adventure-mode gate. |
/reputation add settlement <settlement> <player> <amount> | Adjust a settlement reputation directly (clamped at -1000). Bypasses the adventure-mode gate. |
/levelPermission node: tk10va.xp.admin. All subcommands require Creative mode.
| Command | Description |
|---|---|
/level reset <player> |
Resets the target player's XP and level back to 0. The HUD and tab-list name update immediately if the player is online. |
/ownerRequires op level 4 and Creative mode.
| Command | Description |
|---|---|
/owner |
Claim the block you are looking at (ray-traces up to 5 blocks). Useful for fine-grained per-block protection within a land section. |
Available to all players in adventure mode.
| Command | Description |
|---|---|
/quest detail <quest-name> | Open the quest detail screen for an active quest — shows collected clue pages and completion hint. Tab-completes only your active quests. |
/quest detail <quest-name> cancel | Cancel an active quest. Collectible entities despawn and trinkets are swept from inventory. |
/quest collectibleAll subcommands require Creative mode and tk10va.quest.admin.
Anchors are config-only placement records stored in config/tk10va/collectibles/<questName>.json. They define where collectible entities will spawn for each player who accepts the quest. An admin-preview entity is spawned immediately at the anchor position so placement can be verified in creative mode — right-click it to inspect its data. The preview is invisible to adventure-mode players.
Slot: "trinket" for trinket anchors; the clue's id string for readable anchors. Placing again on the same slot overwrites. Each READ_COLLECTIBLE clue and each Trinket objective must have exactly one anchor — missing anchors mark the quest unavailable at startup.
| Command | Description |
|---|---|
/quest collectible place parchment <quest-name> <clueId> "title" content… | Place a parchment anchor for a READ_COLLECTIBLE clue. <clueId> is tab-completed from the quest's clue list. Look at a block within 10 blocks to set the position. |
/quest collectible place book <quest-name> <clueId> "title" content… | Same as above, using the book collectible type. |
/quest collectible place trinket <quest-name> "title" "content" ["visual-item"] | Place the trinket anchor for the quest's Trinket objective. title and content must be quoted. Optional visual-item is the bare name of a quest item graphic (tab-completed from the PNGs in the mod's textures/item/, e.g. quest_trinket, quest_parchment, quest_fang) rendered on the pedestal — it resolves to the tk10va:<name> item model and defaults to quest_trinket. Right-clicking the placed collectible opens a confirmation dialog before granting the item. |
/quest collectible list [<quest-name>] | List all anchors, optionally filtered to one quest. Shows type, slot, and world coordinates. |
/quest collectible remove <quest-name> <slot> | Remove one anchor by quest and slot. Also kills the admin-preview entity. <slot> is tab-completed. |
All require Creative mode and tk10va.quest.admin.
| Command | Description |
|---|---|
/quest delete <quest-name> | Delete a quest: cancels it for all online players, removes collectible anchors, and deletes the JSON file. |
/quest reset <quest-name> | Preview: shows how many online players have the quest active and how many trinkets they hold. |
/quest reset <quest-name> confirm | Cancel the quest for every online player who has it active, then reload that quest from disk — for a change players must start over with. (Ordinary edits need nothing: they go live by themselves.) |
/quest rename <old-name> <new-name> | Rename a quest — updates the display name, moves the JSON file, updates in-memory record. |
/quest export <quest-name> | Print quest UUID, giver NPC UUID, settlement UUID, clue list, and ready-to-paste dialogue showIf/action lines. |
/quest log show <player> | Show active quests and completion counts for an online player. |
/quest log start <player> <quest-name> | Force-start a quest for an online player. |
/quest log complete <player> <quest-name> | Force-complete a quest for an online player. Applies rewards gated by the player's actual game mode. |
/quest log cancel <player> <quest-name> | Force-cancel a quest for an online player. |
/quest log discover <player> <land-name> | Force-record a land discovery for an online player, resolving any matching DiscoverLand clues. |
/dialogueAll subcommands require permission tk10va.dialogue.admin + op 4 + creative. Dialogue graphs live in config/tk10va/dialogues/<npcDisplayName>.json (one file per NPC). Right-clicking a bound NPC opens its dialogue at the start node; ESC or moving >6 blocks away closes it.
| Command | Description |
|---|---|
/dialogue validate | Run structural validation on every loaded graph and print warnings (broken node refs, unparseable actions/conditions). |
/dialogue test <npc-name> | Open a dry-run session. showIf conditions evaluate against your real state so you see what an adventure-mode player would see — but no quests start, no rep changes, and no clues are recorded. <npc-name> is tab-completed from bound NPCs. |
/merchantAll subcommands require permission tk10va.merchant.admin + op 4 + creative. Merchant catalogues live in config/tk10va/merchants/<npcDisplayName>.json (one file per NPC). Players open a shop from that NPC's dialogue via an option carrying the OPEN_MERCHANT action (guarded by the HAS_MERCHANT condition). Catalogues are authored in the web-admin.
| Command | Description |
|---|---|
/merchant list | List every loaded merchant and its offer count. |
/merchant validate | Run structural validation on every catalogue and print warnings (empty offers, dead lines with no buy/sell price, negative prices). |
/merchant open <npc-name> | Open a merchant's shop screen for yourself to test it. Not a dry-run — purchases and sales are real. <npc-name> is tab-completed from bound NPCs. |
/mountAll subcommands require permission tk10va.mount.admin + op 4 + creative. Mount definitions live in config/tk10va/mounts/<id>.json (one file per mount). A mount is sold to players as a synthetic mount:<id> merchant offer, so its price and reputation gates live on the merchant offer, not the mount file; a mount is resellable only if that offer sets a sell price. Players own many mounts but only one is active, chosen from an inventory parchment, and summoned anywhere by the recall keybind. Definitions are authored in the web-admin.
| Command | Description |
|---|---|
/mount list | List every loaded mount definition with its display name and render kind (vanilla entity type or custom model key). |
/mount validate | Run structural validation on every mount definition and print warnings (blank id, id containing :, non-namespaced vanilla entity type, non-positive stats). |
/resourceAll subcommands require permission tk10va.resource.admin + op 4 + creative. The resource world is a pair of disposable dimensions — tk10va:resource and tk10va:resource_nether — with their own seed (seed in config/tk10va/resource_world.json, derived from the world seed on first start). Every day at 15:30 UTC — or as soon as the world is empty after that — the drop-point origin moves to the next cell of a 1,000,000-block spiral, the old terrain is wiped, and a 17×17-chunk area around the new origin is pre-generated. The resource terrain is also wiped on every server start, and any forceload in either resource dimension is removed automatically — a forced chunk would survive the wipe and pin that terrain for ever.
Sessions: the rift is open on even UTC hours for 60 minutes, then closed for an hour (12 sessions a day). Local times shift with daylight saving, so players are only told how long until the next opening. Walking into a portal land section (create one with /land create <name> portal) while open drops the player on today's shared drop point — the nearest safe ground to the origin — in survival mode; their active mount is dismissed (mounts cannot be recalled inside — the recall keybind is refused there; vanilla animals tamed inside can be ridden, but the daily wipe takes them). While closed, the portal just says when it opens. At the top of a closing hour everyone inside is sent back instantly to a spot just in front of the portal they used, in adventure mode. Players who log out inside are brought back when they next log in. Creative/spectator players keep their mode, can use the portal while it is closed, and are never ejected.
Port-key: every player entering receives a tk10va:port_key (unless they already carry one). Right-click it inside the resource world to return to AshenFall instantly; it is consumed. Entry is refused if the player has no port-key and no free inventory slot. Every way out — port-key, session close, logging in again — removes all port-keys. Like quest trinkets it is bound: it cannot be dropped, stored in any container, ender chest, shulker box or bundle, pulled by a hopper, or placed in an item frame, armor stand, allay, decorated pot or shelf.
Difficulty: the resource world and its nether always run on Hard, whatever AshenFall's difficulty is.
Death: dying in the resource world (or its nether) does not kill you — you are pulled straight back to AshenFall fully healed and fed, keeping your whole inventory and XP. Beds cannot be slept in there (nether beds still explode), respawn anchors cannot be used, and no spawn point can be set in either resource dimension.
Nether: nether portals built in the resource world lead to its own disposable nether (tk10va:resource_nether) and back — never to the real Nether or AshenFall. It is wiped daily with the resource world, and session close sends players in it straight home. The End is closed: eyes of ender cannot be placed in end portal frames there, and an end portal there leads nowhere.
Announcements: when the rift opens, everyone online gets a small notification in the top-right corner (needs the current client jar). In the last minute of a session, players inside see a title and a countdown above the hotbar before they are sent home.
Game mode and protection: survival inside the resource world, adventure everywhere else — checked every second. Land and ownership protection is keyed on the world, not the game mode: it never applies in the resource world, and always applies elsewhere to everyone but creative/spectator players.
| Command | Description |
|---|---|
/resource status | Show whether the rift is open (and any forced open/close override), today's origin (and its nether equivalent, ÷8), the resource seed, the next roll time (UTC), players and loaded chunks per resource dimension, and pre-generation progress. |
/resource open [minutes] | Force the rift open now for minutes (1–60, default 30), even in a closed hour. Combines with the normal schedule: it never cuts a scheduled session short, and a window that runs into a scheduled session stays open until that session ends. Players online get the opening notification. In memory only — a restart clears it. If a forced window spans the 15:30 UTC daily roll, the roll waits until the rift closes. |
/resource close | Force the rift closed until the next scheduled opening (cancels any forced-open window). Everyone inside (except creative/spectator) is sent home within a second, as at a normal close. In memory only — a restart clears it. |
/resource roll | Force the daily roll now: move to the next origin and pre-generate it. Refused while anyone is in the resource world (including creative players, who are not ejected by /resource close) — moving the origin would strand them in the old terrain. The live wipe itself also needs the chunks to have unloaded; otherwise it is skipped and the files are deleted on the next startup. |
/resource tp | Teleport yourself to the surface at today's origin in tk10va:resource for inspection. Your game mode is not changed. |
/surface, /spellAll subcommands require permission tk10va.surface.admin + op 4 + creative. A magic surface is a box of blocks — a wall, floor or ceiling, 1–3 blocks thick and at most 16×16 across — that opens and closes when a player casts its phrase at it from the spellbook. Surfaces live in config/tk10va/surfaces/<name>.json (one file per surface). The game captures the box and its blocks; phrases, mode, animations, timing and chime can be edited in-game or in the web-admin's Surfaces tab (a running game picks up web-admin edits within a few seconds, even while paused). Not available in the resource world.
How it behaves: every surface goes back to its default state on server start, when the dungeon it is in empties, and on /surface reset. While animating, its blocks are invisible barriers and vanilla block displays show the motion (no client mod needed to see it). Blocks of a surface can't be broken outside creative. A close always waits until no mob or player is inside the box. Air inside the box is left alone, so arches and irregular shapes work. Block entities (chests, signs, heads…) can't be part of a surface.
Tab-completion: surface names show the title and distance; modes, states, animation types, directions (only the valid ones for that surface), tick values and sound ids are suggested. Phrases are never suggested.
| Command | Description |
|---|---|
/surface select | Put the Surface Selection Tool (a stick) in your hand — the one you already have, if any: right-click a block = corner 1, left-click = corner 2. |
/surface create <name> [title] | Turn the selection into a surface, capturing its current blocks as the closed look. <name> is 1–32 of a-z 0-9 _ -; [title] is what players see in their spell list (defaults to the name, e.g. crypt_gate → Crypt Gate). The thinnest side of the box is its facing; for a 1-wide slit your look direction decides. Defaults: mode TOGGLE, default CLOSED, open slide UP / close slide DOWN (floors: NORTH/SOUTH), 30 ticks, no auto-close, chime minecraft:block.amethyst_block.chime radius 6. It has no phrase yet. |
/surface set <name> openphrase [words]/surface set <name> closephrase [words] | Set the phrase (1–64 letters, digits, spaces, ' or -; stored lower-case with single spaces). Leave the words off to clear it. |
/surface set <name> mode <mode> | TOGGLE — the open phrase opens it and closes it again · SEPARATE — open phrase opens, close phrase closes · OPEN_ONLY — open phrase opens; it closes only by auto-close or a reset · CLOSE_ONLY — close phrase seals it (use with default OPEN); it reopens only by the timer or a reset. |
/surface set <name> default CLOSED|OPEN | The state it resets to. Takes effect at the next reset. |
/surface set <name> autoclose <ticks> | Close automatically this many ticks after opening (0 = never, max 72000; 20 ticks = 1 s). For CLOSE_ONLY it means reopen this long after being sealed. |
/surface set <name> oncross true|false | Close as soon as a player has passed through the open surface (ignored for CLOSE_ONLY). |
/surface set <name> anim open|close <type> … | slide <direction> [ticks] — the whole surface moves along its face by its own size: a wall can go UP/DOWN or the two sideways compass directions, a floor/ceiling the two in-plane compass directions · recede <direction> [ticks] — sinks back along its facing (the two compass/vertical directions through it) · fade [ticks] — every block shrinks away / grows back · dissolve [ticks] — blocks vanish / appear one at a time · instant. The direction is the way the blocks move (open sliding UP rises; close sliding DOWN comes down into place). ticks is 5–100 (default: keep the current duration). |
/surface set <name> chime <sound> [radius]/surface set <name> chime off | The sound played to a player who comes within radius blocks (0–16) while a spell could act on it (closed, or open for CLOSE_ONLY). Any sound id, e.g. minecraft:block.bell.use. Rings on every approach (step out and back in and it rings again; at most once every 2 s). |
/surface set <name> sound open|close <sound>/surface set <name> sound open|close off | The sound played at the surface when it starts to open / close, heard by everyone nearby. Any sound id; off = silent. Defaults: minecraft:block.beacon.activate / minecraft:block.beacon.deactivate. |
/surface set <name> title <text> | Rename the title shown in players' spell lists (≤ 40 characters). |
/surface recapture <name> | Re-capture the blocks currently in the box as the closed look (the surface must be closed and its chunks loaded). Rebuild it in creative, then recapture. |
/surface open <name> · /surface close <name> | Open / close it now with its animation, ignoring phrases. A close still waits until the box is clear. |
/surface reset <name>|all | Snap to the default state with no animation (unloaded surfaces reset when they next load). |
/surface info <name> | Everything about one surface, including its phrases, live state and warnings. |
/surface list | All surfaces with title, state and position. |
/surface show <name> | Outline the box in particles for 10 seconds (only you see it). |
/surface delete <name> | Put its captured blocks back (if open) and delete it. |
/surface validate | Print load and consistency warnings (missing phrases, invalid animation directions, mode/default mismatches). |
/spell known <player> | List a player's known spells and where each worked (stale ones marked). |
/spell forget <player> <phrase> | Remove a phrase from a player's spellbook (tab-completes their phrases). |
Collectible entities are placed in the world by admins and collected once per player. All collectibles must be bound to a quest.
type: parchment
Clue trigger. Right-click adds the content as a new page in /quest detail <name>. No inventory item granted.
type: book
Same as Parchment — clue trigger only, no inventory item.
type: trinket
Deliverable. Right-click adds the trinket to inventory for return to the quest-giver NPC. Cannot be dropped or stored in containers.
All quest items visible only to players who have the relevant quest active. Trinkets survive death and cannot leave the player's inventory until the quest is completed or cancelled.
Each quest lives in config/tk10va/quests/<displayName>.json. The filename must match the name field exactly. All IDs are raw UUIDs — use /npc inspect for NPC UUIDs, and the land section UUID appears in /land info <name>.
{
"id": "<quest-uuid>",
"name": "Wolf Fang Necklace",
"settlementId": "<settlement-land-uuid>", // optional — null/omit when the giver belongs to no settlement
"giverNpcId": "<npc-uuid>",
"repeatable": false,
"objective": {
"type": "TRINKET",
"trinketTitle": "Wolf Fang Necklace"
},
"clues": [
{
"id": "wolf_lore",
"page": "The alpha hunts the Ash Cairns when the moon is high.",
"trigger": { "type": "TALK_NPC", "npcId": "<npc-uuid>", "nodeId": "wolf_lore" }
},
{
"id": "branns_note",
"trigger": { "type": "READ_COLLECTIBLE" }
},
{
"id": "ruined_shrine",
"page": "A bronze-wrapped fang lies on the altar.",
"trigger": { "type": "DISCOVER_LAND", "landSectionId": "<land-uuid>" }
}
],
"prerequisites": [
{ "type": "MIN_NPC_REP", "npcId": "<npc-uuid>", "amount": 50 }
],
"npcRepReward": 50,
"settlementRepReward": 20,
"xpReward": 150,
"coinReward": 10,
"rareRewards": [
{ "itemId": "minecraft:dragon_head", "chancePercent": 2.5 },
{ "itemId": "minecraft:nether_star", "chancePercent": 0.05 }
]
}
A quest carries no dialogue-node pointers. Acceptance and completion are wired entirely through the giver NPC's dialogue — a START_QUEST action (guarded by CAN_ACCEPT) lets the player accept, and a COMPLETE_QUEST action (guarded by ACTIVE + OBJECTIVE_COMPLETE) turns it in. This is identical for every objective type. The quest validator warns when either action is missing from the giver's dialogue.
| type | Extra fields | Completed when |
|---|---|---|
TRINKET | trinketTitle (string) | Player returns to the giver NPC while carrying the bound trinket and selects the completion dialogue option. The trinket is consumed on completion. |
DISCOVERY | landSectionId (UUID) | Player enters the named land section then returns to the giver NPC and selects the completion dialogue option. Must also have a DISCOVER_LAND clue for the same land. |
GATHER | items — array of { "itemId", "count" } | Player carries all required items, then returns to the giver NPC and selects the completion dialogue option. The items are consumed from the inventory on completion. Each itemId is a full registry id, e.g. minecraft:stick. |
HUNT | mobs — array of { "entityId", "count" } | Player kills the required number of each mob while in adventure mode (progress is tracked per kill), then returns to the giver NPC and selects the completion dialogue option. Each entityId is a full registry id, e.g. minecraft:zombie. Works for hostile or passive mobs. |
Every objective type completes the same way: through the giver NPC's dialogue. The giver's dialogue must contain a COMPLETE_QUEST action; guard that option with ACTIVE:<uuid> + OBJECTIVE_COMPLETE:<uuid> so it only appears once the player can actually hand the quest in. The quest validator warns if the giver's dialogue is missing the START_QUEST or COMPLETE_QUEST action.
In addition to the fixed npcRepReward / settlementRepReward / xpReward / coinReward, a quest may grant probabilistic decorative item rewards via the optional rareRewards array. Each entry is { "itemId", "chancePercent" } where itemId is a full registry id (any vanilla or mod item, e.g. minecraft:dragon_head) and chancePercent is the drop chance in the range (0, 100] — values as small as 0.001 make the item exceptionally rare. The roll happens on every completion, so a repeatable quest can be farmed for the drop. If the inventory is full the item is dropped at the player's feet.
| type | Extra fields | Fires when |
|---|---|---|
TALK_NPC | npcId, nodeId | Player opens the matching dialogue node on the matching NPC. |
READ_COLLECTIBLE | none | Player right-clicks a bound parchment/book entity in the world. Page text comes from the entity's content, not from the JSON page field. |
DISCOVER_LAND | landSectionId | Player enters the named land section for the first time. |
| type | Extra fields |
|---|---|
COMPLETED_QUEST | questId — player must have completed this quest at least once. |
NOT_COMPLETED_QUEST | questId — player must NOT have completed this quest. |
MIN_NPC_REP | npcId, amount — minimum NPC reputation required. |
MIN_SETTLEMENT_REP | settlementId, amount — minimum settlement reputation required. |
MIN_LEVEL | level — minimum player XP level required. |
Each dialogue lives in config/tk10va/dialogues/<npcDisplayName>.json. The filename must match the displayName field exactly. All IDs are raw UUIDs — use /npc inspect to get the NPC's UUID. "END" is a reserved next value that closes the session.
{
"npcId": "<npc-uuid>",
"displayName": "Elder Durn",
"start": "greet",
"nodes": {
"greet": {
"text": "Welcome, traveler. The woods are restless of late.",
"onEnter": ["AWARD_REP_NPC:1"],
"options": [
{ "label": "Any work for me?",
"next": "quest_board",
"showIf": ["NOT_ACTIVE:<quest-uuid>",
"COMPLETED_NEVER:<quest-uuid>"] },
{ "label": "I found the wolf's fang.",
"next": "wolf_return",
"showIf": ["ACTIVE:<quest-uuid>",
"OBJECTIVE_COMPLETE:<quest-uuid>"] },
{ "label": "Just passing through.",
"next": "END" }
]
},
"quest_board": {
"text": "There's a wolf alpha prowling the Ash Cairns. I'd pay well for its fang.",
"options": [
{ "label": "Tell me more.",
"next": "wolf_brief",
"showIf": ["CAN_ACCEPT:<quest-uuid>"] },
{ "label": "Not today.",
"next": "END" }
]
},
"wolf_brief": {
"text": "The alpha haunts the Cairns at dusk. Speak to Brann — he left notes there. Bring me the fang when it's done.",
"options": [
{ "label": "I'll hunt it.",
"next": "wolf_accepted",
"actions": ["START_QUEST:<quest-uuid>"] },
{ "label": "Maybe later.",
"next": "END" }
]
},
"wolf_accepted": {
"text": "Good. Return once you have the fang. Safe travels.",
"options": [
{ "label": "I'll be back.", "next": "END" }
]
},
"wolf_return": {
"text": "You found it! The Cairns are safer already. Here is your reward.",
"options": [
{ "label": "Here it is.",
"next": "END",
"actions": ["COMPLETE_QUEST:<quest-uuid>",
"AWARD_REP_NPC:50",
"AWARD_REP_SETTLE:<settlement-uuid>:20"] }
]
}
}
}
| Action string | Effect |
|---|---|
START_QUEST:<uuid> | Calls QuestLog.start. No-ops silently when CAN_ACCEPT would fail at runtime. |
COMPLETE_QUEST:<uuid> | Completes the quest and triggers all configured rewards. |
AWARD_REP_NPC:<n> | Add n NPC rep with the NPC currently being talked to. |
AWARD_REP_SETTLE:<settleUuid>:<n> | Add n reputation with the named settlement. |
GIVE_ITEM:<itemId>:<count> | Give an item stack to the player (e.g. minecraft:golden_apple:1). |
OPEN_MERCHANT | Open the shop screen for this NPC (no argument). Requires a merchant catalogue bound to the NPC — pair it with the HAS_MERCHANT condition. Opening the shop ends the dialogue (the shop takes over the screen and closes back to the game), so the option's next is ignored — set it to "END". |
showIf conditionsMultiple conditions are ANDed. Options whose any condition fails are hidden. Duplicate the option to express OR.
| Condition string | True when |
|---|---|
ACTIVE:<uuid> | Quest is currently active for the player. |
NOT_ACTIVE:<uuid> | Quest is not active. |
COMPLETED_BEFORE:<uuid> | Quest completed at least once. |
COMPLETED_NEVER:<uuid> | Quest never completed. |
CAN_ACCEPT:<uuid> | Compound: not active + fewer than 3 active quests + all prerequisites met + player in adventure mode. |
OBJECTIVE_COMPLETE:<uuid> | The quest's objective requirement is satisfied and the player is ready to turn it in — the single "quest can be completed" condition, generic across every objective type: trinket held · all clues collected (discovery) · all items carried (gather) · all kill counts reached (hunt). Use this (with ACTIVE) to gate the COMPLETE_QUEST option so it only shows when the quest can actually be handed in. (CLUES_COMPLETE is a deprecated alias kept for older dialogue files.) |
DISCOVERED_LAND:<uuid> | Player has entered the named land section at least once. |
NOT_DISCOVERED_LAND:<uuid> | Player has never entered that land section. |
REP_NPC_GTE:<n> | NPC reputation with the current NPC is ≥ n. |
REP_SETTLE_GTE:<settleUuid>:<n> | Settlement reputation ≥ n. |
TIER_NPC_GTE:<tier> | NPC rep tier ≥ the named tier: HOSTILE / UNFRIENDLY / NEUTRAL / FRIENDLY / HONORED. |
HAS_ITEM:<itemId> | Player carries at least one of this item (e.g. tk10va:quest_trinket). |
HAS_MERCHANT | A merchant catalogue is bound to this NPC (no argument). Use it to gate the "Show me your wares" option so the shop button only appears when a shop actually exists. |
Clue recording. There is no RECORD_CLUE action. TALK_NPC clues record automatically when the player opens the matching node on the matching NPC — no extra authoring needed.
name / displayName field exactly (case-sensitive). Allowed characters: letters, digits, spaces, hyphens, underscores.id field (quest) and npcId field (dialogue) are canonical identifiers. Use /npc inspect to get NPC UUIDs; land/settlement UUIDs appear in /land info <name>.DISCOVERY objective, add at least one DISCOVER_LAND clue whose landSectionId matches the objective — nothing is synthesised automatically.READ_COLLECTIBLE clues, place an anchor with /quest collectible place parchment|book. The preview entity spawns immediately in creative mode for verification.Each merchant lives in config/tk10va/merchants/<npcDisplayName>.json (one file per NPC, keyed by npcId). Author them in the web-admin's Merchants tab. A player opens the shop from the NPC's dialogue via an option with the OPEN_MERCHANT action, guarded by the HAS_MERCHANT condition.
{
"npcId": "<npc-uuid>",
"displayName": "Aldric",
"offers": [
{ "itemId": "minecraft:iron_sword", "buyPrice": 120, "sellPrice": 40,
"minNpcRep": 25,
"minSettlementRep": { "settlementId": "<settlement-uuid>", "amount": 50 } },
{ "itemId": "minecraft:bread", "buyPrice": 3, "sellPrice": 1 }
]
}
| Field | Meaning |
|---|---|
itemId | Full registry id of any Minecraft (or mod) item, e.g. minecraft:iron_sword. Use mount:<mountId> to sell a mount — buying grants the mount entitlement (not an item), and it can only be bought once. The item picker lists mounts automatically. |
buyPrice | Coins the player pays to buy one. 0 or omitted → the item can't be bought (sell-only). |
sellPrice | Coins the NPC pays when buying one back from the player. 0 or omitted → the item can't be sold (buy-only). |
minNpcRep | Optional. Minimum reputation with this NPC required to buy the item. Selling is never gated. |
minSettlementRep | Optional { "settlementId", "amount" }. Minimum reputation with the named settlement required to buy the item. Omit for no settlement gate. |
Set a buy price, a sell price, or both per line. Stock is unlimited. The shop screen has Buy and Sell tabs and a cart: players adjust quantities per line and confirm once to buy or sell everything in the cart. Reputation-locked buy lines are shown greyed out with a reason. The server re-checks coins, reputation, and (when selling) inventory on every checkout — client prices are never trusted. The web-admin flags a merchant whose NPC has no dialogue OPEN_MERCHANT option (players couldn't open it) and a dialogue that uses OPEN_MERCHANT/HAS_MERCHANT with no matching merchant file.
Each mount lives in config/tk10va/mounts/<id>.json (one file per mount). A mount is sold to players by adding a merchant offer whose itemId is mount:<id> — so price and reputation gates live on the merchant offer, not here, and a mount is resellable only when that offer sets a sellPrice. Players own many mounts but keep only one active, chosen from an inventory parchment and summoned anywhere with the recall keybind.
{
"id": "swift_horse",
"displayName": "Swift Horse",
"render": { "kind": "vanilla", "entityType": "minecraft:horse" },
"stats": { "moveSpeed": 0.3, "jumpStrength": 0.6, "maxHealth": 30, "stepHeight": 1.0 }
}
| Field | Meaning |
|---|---|
id | Unique mount id. Must not contain : (it becomes the merchant offer mount:<id>). This is the file name. |
displayName | Name shown in the shop and the mount selection parchment. |
render.kind | vanilla — spawn an existing entity type; set render.entityType to a namespaced id (e.g. minecraft:horse, minecraft:sheep). Or custom — spawn the mod's mount; set render.modelKey to a custom model (ashen-sheep, beast, canine, feline) and optional render.skin (ashen-sheep, black_cat, black_wolf, brown_cat, brown_wolf, grey_cat, grey_wolf, white_cat, white_wolf; blank = black_wolf). An unknown model key falls back to beast. Making a new model: see Custom Mount Models. Either way the mount is fully steerable (look to turn, W to go). |
stats.moveSpeed | Movement speed attribute (> 0; horse-like ≈ 0.1–0.35). |
stats.jumpStrength | Jump strength attribute (≥ 0; 0 = no boosted jump). |
stats.maxHealth | Max health in half-hearts×2 (> 0; e.g. 30 = 15 hearts). |
stats.stepHeight | Block step height (≥ 0; 1.0 walks up a full block). |
Omitting stats (or any field within it) falls back to sensible defaults. Author mounts in the web-admin's Mounts tab. Validate with /mount validate; saved changes go live by themselves within a few seconds. Every mount type is steerable — you look to turn and press forward to move — whether it's an equine, another vanilla mob (sheep, cow, …), or a custom mount. stats.moveSpeed sets how fast it goes; stats.jumpStrength its jump height.
Each magic surface lives in config/tk10va/surfaces/<name>.json. Create surfaces in-game (/surface create) — the game writes the box and blocks. The web-admin edits the other fields and refuses a save if the box changed in-game since the page loaded.
{
"id": "9f1c…", "name": "crypt_gate", "title": "Crypt Gate",
"world": "minecraft:overworld",
"min": [120, 64, -40], "max": [124, 67, -40], "normal": "Z",
"blocks": ["minecraft:stone_bricks", "…"],
"openPhrase": "aperio 7", "closePhrase": null,
"mode": "TOGGLE", "defaultState": "CLOSED",
"autoClose": { "afterTicks": 200, "onCross": true },
"openAnimation": { "type": "SLIDE", "direction": "UP", "durationTicks": 30 },
"closeAnimation": { "type": "SLIDE", "direction": "DOWN", "durationTicks": 30 },
"chime": { "sound": "minecraft:block.amethyst_block.chime", "radius": 6 },
"sounds": { "open": "minecraft:block.beacon.activate", "close": null }
}
| Field | Meaning |
|---|---|
id, name, world, min, max, normal, blocks | Written by the game — don't edit. normal is the axis the surface faces along (X, Y for floors/ceilings, Z). blocks lists the captured block states, x outermost, then y, then z. |
title | Shown in players' known-spell lists. |
openPhrase, closePhrase | The words, or null. Case and extra spaces are ignored on load. |
mode | TOGGLE · SEPARATE · OPEN_ONLY · CLOSE_ONLY (see /surface set mode). |
defaultState | CLOSED or OPEN. |
autoClose.afterTicks, autoClose.onCross | Timer (0 = off, max 72000) and close-after-passing-through. |
openAnimation, closeAnimation | type: SLIDE · RECEDE · FADE · DISSOLVE · INSTANT. direction (UP DOWN NORTH SOUTH EAST WEST) only for SLIDE (along the face) and RECEDE (along normal). durationTicks 5–100. An invalid animation plays as FADE. |
chime.sound, chime.radius | Sound id and radius (0 = off, max 16). |
sounds.open, sounds.close | Sound id played when it starts to open / close; null = silent. A missing key uses the default (beacon activate / deactivate). |
Custom mounts (render.kind: custom) are modelled, textured and animated in
Blockbench and rendered in-game by GeckoLib.
Everything about a model — its shape, which way it faces, its animations and where the rider sits — is
decided in Blockbench. The build only copies the exported files into the mod; it never fixes a model up.
So if something looks wrong in-game, the fix is always in Blockbench, then re-export.
<key> (lowercase; - or _ are fine) under
src/main/resources/assets/tk10va/:geckolib/models/entity/mount/<key>.geo.json — the model (required)geckolib/animations/entity/mount/<key>.animation.json — its animations (optional)textures/entity/mount/<skin>.png — one or more coats (skins)render.modelKey refers to. Current models: ashen-sheep, beast, canine, feline.
0, 0, 0) and set that group's rotation, e.g. Y = -90
for a model whose head points to +X. Its children and their animations turn with it. If it then walks
backwards in-game, use the opposite sign (90).seat_anchor, and check its pivot and rotation are both 0, 0, 0.
Add a locator inside it named exactly seat and move it onto the animal's back
where the rider should sit:
X = 0 keeps the rider centred, Y is the height of the back,
+Z moves the rider towards the tail. No seat → the rider sits 1.6 blocks up
(the hitbox top), which floats above most animals.
textures/entity/mount/<skin>.png. Each PNG there is a coat any mount can use via
render.skin; more coats for the same model are just more PNGs with the same UV layout.
move.walk and misc.idlemove.walk while moving and misc.idle otherwise. Any other name is never played.
For each, open its properties and set Loop Mode → Loop (otherwise it plays once and freezes).
Animate the bones in the model's own frame: for a north-facing model legs swing on X.
query.head_y_rotation (the head's angle relative to
the body, in degrees). In both animations, select the head bone and type
query.head_y_rotation into the Y rotation field of every head
keyframe — a keyframe left at 0 makes the head drift back to straight between keyframes. Optionally put
query.head_x_rotation into X for the head to pitch up and down. Other channels (e.g. a nod)
can stay as normal numbers.
-query.head_y_rotation.geckolib/models/entity/mount/<key>.geo.json.geckolib/animations/entity/mount/<key>.animation.json.<key> for both files. Changing only the seat or the shape? Re-export just the model.
.geo.json, .animation.json and .png files and push.
No Gradle or other tools are needed on your machine: the server's build finds the new model, works out its
seat and packs everything into the mod. Its log (the Forgejo build run, step Build and test)
lists the models and seats it found, e.g.
Mount models: ashen-sheep (seat [0, 20, 5]), beast (seat [0, 17, 0]), …
For a centred seat towards the tail the first number is 0 and the last is positive. Then an admin runs the
deploy workflow (after bumping the mod version).
custom, your model key and a skin
(the dropdowns list what the last game start found), then grant it in Players → Mounts.
In-game, check: the head leads when walking forward; the legs move while walking and idle when standing;
the rider sits on the back; strafing turns the body while the head keeps looking ahead.
| You see | Cause | Fix in Blockbench |
|---|---|---|
| Model doesn't animate | Animations aren't named move.walk / misc.idle. | Rename them exactly (step 5), re-export animations. |
| Animation plays once, then freezes | Loop Mode isn't Loop. | Animation properties → Loop Mode → Loop. |
| Mount is turned 90° (walks sideways) | Modelled facing another way than north (−Z). | Wrap everything in one top-level group and rotate it on Y (step 2). |
| Mount walks backwards | Facing south (+Z), or the group rotated the wrong way. | Rotate the top-level group by 180, or flip the sign (−90 ↔ 90). |
| Rider floats above the back | No seat locator (rider goes to the 1.6-block hitbox top), or its Y is too high. | Add/lower the seat locator (step 3). |
| Rider sits off to the side after moving the seat | The locator is inside a rotated group; Blockbench exports it unrotated. | Move it into its own top-level group with no rotation (step 3). |
| Head stays straight while strafing | No query.head_y_rotation on the head. | Add it to the head's Y in every keyframe of both animations (step 6). |
| Head swings back and forth while turned | Some head keyframes have a plain number in Y. | Put query.head_y_rotation in every head keyframe. |
| Head turns away from where the rider looks | Sign is reversed for this model. | Use -query.head_y_rotation. |
| Texture is stretched or misplaced | The PNG's size differs from the project's texture size. | Keep them equal (e.g. both 80×80), re-save the PNG. |
| Purple/black checkerboard texture | render.skin names a PNG that doesn't exist. | Pick a skin from the dropdown, or save the PNG under that name. |
| Shows as the default beast | render.modelKey doesn't match a .geo.json file name. | Use the exact file name (without .geo.json). |
| New model or skin missing from the web-admin | The lists come from the last server start. | Check the new build is deployed and the server restarted, then reload the web-admin page. |
Decorations are solid blocks made from a Blockbench model — a mushroom, a statue, a whole tree. They can be still or gently animated, and bigger than one block. Like mounts, everything is decided in Blockbench and the build only packs the files: push them and they appear in the game's creative inventory.
<key> (lowercase letters, digits,
_ - . only) under src/main/resources/assets/tk10va/:geckolib/models/block/decor/<key>.geo.json — the model (required)textures/block/decor/<key>.png — its texture (required)geckolib/animations/block/decor/<key>.animation.json — only if it moves (optional)tk10va:decor_<key>,
named after the key (giant_mushroom → “Giant Mushroom”).
textures/block/decor/<key>.png,
with the same <key> as the model. It is also used for the little bits that fly off when it's broken.
misc.idlemisc.idle
with Loop Mode → Loop. It plays all the time. Animation only changes how it looks — what is solid
stays the model as built.
geckolib/models/block/decor/<key>.geo.json;
if animated, export the animations to geckolib/animations/block/decor/<key>.animation.json.
Decorations: giant_mushroom, willow_tree (animated)
A warning there means a bad file name or a missing texture. An admin then deploys as usual.
/give @s tk10va:decor_<key>. Its inventory icon is the model itself, shrunk to
fit. Breaking any part of a big decoration removes all of it.
| You see | Cause | Fix |
|---|---|---|
| Not in the creative tab | File name has capitals/spaces, or the build with it isn't deployed. | Rename to lowercase a-z 0-9 _ - .; check the build log line; deploy. |
| Purple/black checkerboard | No textures/block/decor/<key>.png, or a different key. | Save the PNG under exactly the model's key. |
| Stretched texture | PNG size differs from the project's texture size. | Keep them equal and re-save. |
| Floats or sinks into the ground | The model isn't standing on Y = 0. | Move it so its base is at Y = 0. |
| Off-centre on its block | Not built around the grid's centre. | Centre the base on X = 0, Z = 0. |
| Faces the wrong way | Decorations always face north as modelled. | Turn it in Blockbench (e.g. rotate a top-level group). |
| Invisible walls next to it | A rotated cube collides as the upright box around it. | Split long rotated parts into smaller cubes. |
| Can walk through the top of a tall one | It reaches higher than 15 blocks (or wider than 4 to a side). | Keep it within the limits (step 3). |
| Won't place | Something occupies the space a big decoration needs. | Clear the area first. |
| Doesn't move | No animation file, or it isn't named misc.idle / not looping. | See step 5. |
Admins can place hazard blocks in the world to create environmental dangers for encounters and exploration.
tk10va:poison_waterA custom fluid that looks and flows like normal water but with a sickly green tint. Players who enter it are afflicted with Poison II, which starts draining health immediately on entry and reduces it down to half a heart — but cannot kill on its own. The effect lingers for 15 seconds after leaving the water.
You can swim and drown in it. Respiration and Aqua Affinity enchantments work normally.
Visually distinct from normal water — the green colour clearly signals danger to players.
The Poison II effect persists for 15 seconds after exiting — escaping the pool is not an instant cure.
The Poison Water Bucket is available in the Tools & Utilities creative tab — right-click to place it like any other bucket. For larger areas use the fill command:
/fill x1 y1 z1 x2 y2 z2 tk10va:poison_water
Scooping placed poison water with an empty bucket returns a Poison Water Bucket.
The fluid obeys the waterSourceConversion game rule for infinite-source behaviour.
A visual catalogue of the mod's decorative heads, NPC skins, and mount coats. Generated straight from the mod's textures, so it always matches what ships in ashenfall-1.1.33-client.jar.
Custom skull blocks — place on floors or walls. Grab one from the Functional Blocks creative tab, or /give @s <id>. Hover a head to spin it.
tk10va:apple_red
tk10va:barrel_beer
tk10va:barrel_wheat
tk10va:barrel_wine
tk10va:basket_log_jungle
tk10va:basket_log_oak
tk10va:basket_log_oak_dark
tk10va:basket_log_spruce
tk10va:beehive
tk10va:beer_pint
tk10va:book_bible_black
tk10va:book_bible_red
tk10va:book_blue
tk10va:book_crimson
tk10va:book_crimson_journal
tk10va:book_gold_spine
tk10va:book_green
tk10va:book_ligh_green_journal
tk10va:book_light_green
tk10va:book_quran
tk10va:disfigured_skull
tk10va:hay_tide_single
tk10va:hay_tied_double
tk10va:jar_honey
tk10va:jar_potion_label
tk10va:jar_potion_purple
tk10va:jar_pumpkin
tk10va:jar_water_holy
tk10va:lantern_jack_o
tk10va:lantern_rustic
tk10va:ore_iron
tk10va:pie
tk10va:pot_flow
tk10va:pot_flower_cyan
tk10va:pot_flower_pink
tk10va:pot_flower_purple
tk10va:pot_flower_red
tk10va:pot_flower_yellow
tk10va:pot_guster
tk10va:pot_scraped
tk10va:sack_flour
tk10va:sack_trophy_fishing
tk10va:sack_trophy_potion
tk10va:skeleton_pirate
tk10va:skull_mossy
tk10va:stack_book_magic
tk10va:stack_bread
tk10va:stack_paper
tk10va:statue_bear
Skins available for custom NPCs. The name under each face is the value you pass to /npc spawn <name> <skin> and /npc texture. Click a face to view the full 3D model.
Coat skins for custom mounts, grouped by model family. The live mount roster (names, prices, stats) is configured per-server in the admin panel; these are the coat textures that ship with the mod.