Character & Skills Reference

Each node holds multiple ranks. A node needs rank ≥1 in the node before it to unlock, and its own rank can never exceed that prior node's current rank — forcing balanced investment up the chain rather than rushing straight to the strongest node.

There is no separate profession system or profession point pool. "Carpenter," "miner," etc. are just descriptive labels for whatever skill combination a player has actually invested in.

Reads the event's current value and boosts it by the rank's percentage before handing the event back.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Reads the real per-depth ore-weight table (definitions.db) for the player's region, then rolls a bonus toward whichever ore is genuinely rarer at that depth — not a guessed curve.

Deducts a small stamina cost on every qualifying hit — a cost the plugin introduces itself — then reduces that deduction by the rank's percentage.

Reads the event's current value and boosts it by the rank's percentage before handing the event back.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Checks the target's type ID against a maintained category list, then rolls a bonus-item chance if it matches.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Deducts a small stamina cost on every qualifying hit — a cost the plugin introduces itself — then reduces that deduction by the rank's percentage.

Reads the event's current value and boosts it by the rank's percentage before handing the event back.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Checks the target's type ID against a maintained category list, then rolls a bonus-item chance if it matches.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Directly shortens the plant's next-growth-stage timer by the rank's percentage.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Rolls a chance sized to the rank; on success, bumps the resulting item stack instead of consuming the input.

Cow's real milkduration (8000s) and milkcooldown (600s) define the base collection window — this node grants a bonus item on top of the normal yield, scaled by rank.

For animals whose real maxchilds exceeds 1 (pig, shewolf, arcticshewolf), biases the litter roll toward that maximum rather than the minimum, scaled by rank.

Directly advances the animal's age value, scaled by rank, to speed up maturation.

Rolls a chance sized to the rank; on failure only, cancels the event to represent a missed attempt.

Reads the event's current value and boosts it by the rank's percentage before handing the event back.

Rerolls toward a low-spawnchance entry (e.g. blobfish at 5%, tuna at 20%) instead of the default weighted pool, scaled by rank.

Applies only to species with requiresbait=1 (salmon, tuna, koi, carp, shrimp, blobfish) — rolls a refund chance on those catches specifically, scaled by rank.

Compares against real minwaterdepth thresholds (e.g. salmon 40, tuna 50) — grants a bonus only once the player is actually deep enough for that species to spawn.

Reads the event's current value and boosts it by the rank's percentage before handing the event back.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Rolls a chance sized to the rank; on success, grants the bonus item straight to the player's inventory.

Reduces the native stamina cost of sprinting while tracking, scaled by rank.

Boosts the event's damage value by the rank's percentage — e.g. rank 5 on a 70-damage huntingknife adds roughly 8.75 damage.

Nudges the fired shot's rotation toward the target to reduce spread, scaled by rank; damage bonus applies at the eventual hit event.

Reads the incoming damage value and reduces it by the rank's percentage before it's applied.

Rolls a chance sized to the rank; on success, bumps the resulting item stack instead of consuming the input.

Applies a stat or durability modifier to the crafted item object, scaled by rank.

Applies a stat or durability modifier to the crafted item object, scaled by rank.

Rolls a chance sized to the rank; on success, bumps the resulting item stack instead of consuming the input.

Boosts the placed element's real basestrength (which already varies 30–100 by shape) by the rank's percentage.

Checks the target's type ID against a maintained category list, then rolls a bonus-item chance if it matches.

Checks the target's type ID against a maintained category list, then rolls a bonus-item chance if it matches.

Applies a stat or durability modifier to the crafted item object, scaled by rank.

Applies a stat or durability modifier to the crafted item object, scaled by rank.

1. Home server calls Definitions.getAllPlantDefinitions() and getAllConstructionDefinitions() at startup. No other server ever runs this scan.
2. Each definition's real type/material/pickupitem fields are read directly — no name matching required.
3. Home pushes the finished typeID → category table to the backend over the existing persistent socket.
4. Backend caches it (write-through, same pattern as player data) and serves it to every server — including Home — on connect.

World.createStorage() creates a plugin-owned container tagged StorageType.API — distinct from vanilla Chest/Vehicle/Npc storages. Player.showStorage(storageID) / hideStorage() open and close it exactly like a native chest.

Storage.setSlotCount() is a plain integer, so a "Carrying capacity" stat — paid for with character-level stat points, not skill points — can drive it directly: base 9 slots + 1 per point invested, recalculated whenever the storage is (re)created.

On disconnect/transfer, serialize the storage's contents (Storage.getItems()) into the player data package as its own module, not folded into the core inventory blob — keeps it toggleable and extensible later. On the destination server, call World.createStorage() fresh and replay the item list back in via addItemToSlot().

This is the same force-sync-on-transfer pattern already used for inventory — a second, independent payload riding alongside it, not a new sync mechanism.

Each socketed hide is stored as a small ID packed into Item.setValue(): 6 bits per slot supports up to 63 hide types. Saddles use 4 slots (24 bits total — health, speed, whistle distance, whistle cooldown); saddle bags use 2 slots (12 bits — both extra capacity). The actual bonus amounts are never stored on the item at all.

The bonus each hide grants per slot lives in backend config, not on the item — synced to every server on connect, the same handshake pattern already used for currency, skill trees, and the type lookup table. Adjusting a hide's power is a config edit, not a code change.

Saddle bags use the same hide roster but a different rationale: bonus scales with hide surface area/animal size rather than speed, since carrying capacity is about material, not agility. Same backend-config sync pattern as the saddle table above.

Unicorn is not a separate item — it's horsehide with itemtexture/variant=4, dropped by horse-variant NPCs 14 and 15 in npcs_variants (800 HP source, 1.0% and 0.1% spawn chance respectively — the rarest, toughest entry in the whole dataset). Item.getVariant() already distinguishes it natively from common horsehide.

Npc.setPosition() is confirmed directly — whistling reads the player's current position and calls setPosition() on the mounted Npc. The cooldown itself isn't an API concept: plain plugin-side timestamp tracking, compared against now plus whatever the socketed cooldown-reduction stat subtracts.

Since the socket configuration lives inside Item.setValue(), it rides along automatically with whatever serialization already happens for inventory/equipped items in the player data package — no new sync mechanism, same as the backpack.

One function — showToast(player, text, backgroundColor, borderColor, duration) — callable from any system. Skill rank-ups, currency changes, backpack-respec-blocked messages, and saddle stat notifications all call the same function instead of each building its own popup.

Toasts are their own top-level UIElement, added directly via player.addUIElement() — not nested under the Skills/Currency/Map page-switching root. This makes them always visible: they render regardless of which page is open, or even if the whole page UI is hidden entirely.

This is the one real architectural decision this system forces: two separate UI roots per player, not one — the page root and the always-visible toast root, each managed independently.

Capped at 4 visible toasts. A 5th incoming toast immediately dismisses the oldest (instant removal, no fade) to make room, then the new one appears. Dismiss is likewise instant on timeout — no animation.

Each toast stores its own creation timestamp. A shared tick (via UpdateEvent, checked periodically rather than every frame to avoid overhead) walks the active toast list per player and instantly removes anything past its duration.

Backend config defines each currency's value type (int/double/float), icon, and is-tradable flag — synced to every server plugin on connect.

Base currency is Gold Coin; more currencies can be added later purely through config, no code changes required.

Physical location in each main city; leaning toward dynamic (supply/demand) exchange rates, mechanics still undecided.

Pick Mining — the most-verified skill with the cleanest hooks. Build the ranked-node data model and the unlock-gate/rank-ceiling enforcement server-side. Wire PlayerHitTerrainEvent to Swing power and Ore yield. Skip Prospecting and Endurance initially — they carry extra dependencies (region data, a custom stamina system).

Done when: a player can spend a point, see Swing power's damage bonus actually apply in-game, and the rank persists through a disconnect/reconnect.

Balances just live inside the player data package, so this is mostly data-model work: add currency fields, a basic admin/debug command to grant currency, confirm it round-trips through sync like everything else in the package.

Done when: currency balance survives a disconnect/reconnect cycle.

Add the Definitions.getAllPlantDefinitions()/getAllConstructionDefinitions() scan on Home, build the typeID → category table, push it through the existing config-handshake pattern.

Done when: a spoke server logs the received category table on connect and it matches what Home actually scanned.

With the pattern proven on Mining, the rest go faster: Felling and Gathering reuse the lookup table immediately. Then Plant Farming, Hunting, Combat, Fishing, Husbandry, and finally the thinner Crafting skills (Smithing, Cooking, Construction, Tailoring).

Extraction and combat skills only need player/hit events already built for Mining; Construction specifically needs the lookup table's wood/stone split.

Define the in-world Area per city, wire PlayerEnterAreaEvent to the per-player discovery flag, and connect discovered-portal teleportation into the existing transfer flow — it's a trigger, not a new system. See the plan entry.

Exchange market rate mechanics, cache eviction tuning under real load (see TODO), TLS if moving beyond local testing, an admin re-scan command for the lookup table.