Repository navigation
Troubleshooting
Boards generate with new vanilla villages. Installing Taskbound does not add pavilions to already generated chunks. Travel to new terrain or craft a Task Board.
If a newly generated vanilla village is missing one, note the Minecraft/mod version, seed, coordinates, village type, and other world-generation mods when reporting it. Those details help reproduce the placement.
Search chunks generated with Taskbound 1.1.0. Nether pavilions need a dry cave floor below the bedrock roof, with enough room and support for the shelter. End pavilions use the substantial outer-island highlands and midlands; they do not appear on the central dragon island, barrens or small islands.
The placement grids use 23-chunk spacing in the Nether and 85 in the End. A grid candidate can be rejected for terrain or biome reasons, so those values are not guaranteed distances between boards. You can also craft and place a board in either dimension. Generated and player-placed boards become Porter destinations when their chunks load, subject to the task's route and portal requirements.
The default limit is three active or completed-but-unclaimed tasks. Claim completed work or abandon an unwanted task at a board. Reputation increases available offers, not active capacity. Servers can change the limit.
Check the selected task's exact requirements:
- Was the task accepted before the action?
- Is its current objective or phase active?
- Are the location, biome, time, weather, height, effects, and equipment correct?
- Does it require personally crafting, mining, fishing, or brewing rather than possessing an item?
- Does it need the same physical rod, weapon, crafted output, or structure?
- Does the killing hit match its damage type/tag, and does the weapon mod retain your identity as the attacker or projectile owner? Anonymous damage cannot advance personal tasks. A source without weapon information also cannot satisfy a specific-weapon requirement.
- Has a timer expired or a survival restriction failed?
See Task types and rules for mechanic-specific details. For brewing, supply the final ingredient yourself and stay online through completion. For tracked fishing, use a qualifying rod when you cast. For hand-ins, inventory possession alone does not finish submission.
Finish non-hand-in objectives first. Supply the displayed total for every request. Tagged requests may use several different matching stacks; extra available slots do not all need filling. Potion form, enchantments, and task-produced-item requirements can make otherwise similar items ineligible. The task must still be valid and unexpired.
If no hand-in screen opens for a custom task, check the 36-stack limit. Closing or canceling returns deposits; overflow may drop nearby when the inventory is full.
Porter checks automatically registered nearby boards; opening each destination is unnecessary. Starter routes need boards 256–768 horizontal blocks apart, so two boards 968 blocks apart cannot make a starter route. Higher tiers use longer distances, and active routes or cooldowns can also restrict offers. Boards register as their chunks load; the search does not generate new terrain. Nether/End routes require a previous ordinary-portal visit to each destination dimension; teleporting there does not establish that prerequisite. If Porter itself is offscreen, scroll over the guild banners.
Follow the assigned order and carry every required sealed parcel or receipt. A daytime/nighttime delivery must reach its final board in that phase. A return route pays only after coming back. Recover a dropped parcel normally; generic named items and other players' cargo are invalid. Broken destination boards cancel affected tasks without a penalty. Teleporting, riding during Walking Post, exceeding fragile damage or missing a deadline can fail a route.
The guide is issued when you accept a Porter task and targets its current stop. Recover a dropped guide; it is not automatically replaced. A guide stored or dropped when the task ends is removed from your inventory if you later recover it. Your ordinary compasses are not removed. The delivery compass spins while you are in a different dimension from its target.
Automatic beacons require Xaero's Minimap, with porter_xaero_waypoints = true under [ui] in config/taskbound-client.toml. World Map alone does not provide that beacon system. Keep the guide in your inventory. Turning the option off removes Taskbound's marker; the compass still works.
1.1.0 preserves edited giver/category files. Customized categories can retain the previous Gathering catalog; compare them with default_configs/ and merge the new Farmer category references when ready. The one-time updater backs up unchanged originals under .updates/1.1/; keep its .defaults-1.1 marker after the update. An unchanged stock wheat icon is upgraded to the Farmer iron hoe and backed up under .updates/farmer-icon/; custom giver edits are preserved. Check datapack overrides too. Starcatcher replaces all vanilla Angler offers; Farmer's Delight replaces only 15 Farmer offers. Old accepted tasks are intentionally retained.
Craft another using one book, one feather, and one compass. The automatic first-login journal is a one-time grant.
Edit the active server TOML, not a client's copy. A valid custom currency overrides automatic Numismatics conversion. Invalid item IDs fall back to spurs or emeralds.
Currency settings affect newly generated rewards. Existing offers keep their payout until replaced, and accepted tasks keep it permanently. Fixed level gifts and non-emerald rewards are not converted. Currency guide.
Make sure you edited the server's active files and ran /reload. Check for a same-ID world datapack override. Inspect a new offer rather than a task already accepted before the edit.
If reloading reports an error, correct the named JSON or reference first. Common causes are trailing commas, wrong IDs, unsupported parameters, missing templates, or an empty category. A failed live reload intentionally retains the previous valid catalog.
Keep .initialized for deliberate deletions. Removing it restores missing defaults, but preserves existing modified files. A full default restoration requires moving the old definition folder aside, not merely copying over it. Back up first and follow Restore clean defaults.
Configuration restoration does not erase saved reputation, gift claims, completed-task history, or accepted tasks. Those are separate player state.
This is intentional. Open the board's Active view and click the selected guild again for All active tasks. Saved work and rewards remain usable after a giver is removed; banked reputation is retained if the giver returns.
Main levels 1, 5, 10, 15, and 20 unlock task tiers instead of giving an intermediate gift. Claim intermediate gifts at the board, not in the journal. Each guild/level gift is claimable once; changing or restoring its JSON does not reset an existing claim.
Include your Taskbound, Minecraft, and NeoForge versions; what you did; what you expected; and what happened. Screenshots of the task's requirements and progress help. For a custom definition, include the relevant files and reload error. Review logs before sharing them and remove personal information.
Taskbound 1.1.0 by voidanomaly. Wiki home · GitHub repository.