đŹď¸ TradeWinds#
Created and maintained by tastybento.
TradeWinds is a sea-trading game mode for BentoBox: an endless, procedurally generated ocean scattered with NPC trading islands. Your players start with nothing but a rowing boat and a pocketful of coalâand the boat is their cargo hold. Buy low at a farming island, sell high at an industrial port, and watch the money roll in⌠or take the shortcut through smuggling, bounty hunting, and piracy, and deal with what follows.
If you ever lost a weekend to Elite or TradeWars 2002, this is that feeling, rebuilt in Minecraft. If you didn'tâyour players are about to find out why you would have.
đ§ Why players get hooked#
- đď¸ An endless seeded ocean world. Every island's position, type, tech level, security band, biome, and name derives from a single seed. Players can explore and find novel locations. Use the default seed or pick a new one to have a unique world. Share your seed and another server gets the exact same world.
- âľ The boat IS the hold. Cargo lives in the ship, the ship can be upgraded through 20 hull ranks (Bamboo Raft â Pale Oak Chest Boat), and losing the ship means something. One player, one boatâevery hull decision matters.
- đ A market worth reading. Eight island personalities (farms, mines, fisheries, forests, industry, luxury, frozen portsâŚ) each buy and sell differently, and every trade nudges local prices. The good routes are discovered, not posted.
- ⥠Two ways to travel, both fair. Rowing is free, slow, and takes you through lawless water, but potential riches. Warping is instant but burns fuel from the holdâand a 5% misjump drops you into the Interstice, a hostile nether sea where the wart, the blaze rods, and the wither watchtowers are. Neither way ever strictly beats the other; that tension is the game.
- đşď¸ Charts, stars, and rank. Raising the chart floats a hologram compass of everything you've charted. Every island charted by players climbs the Seafarer ladderâ19 ranks from Deck Hand to Mythic Mariner, with a built-in top-ten leaderboard and placeholders for your scoreboard.
- đ An island of your ownâearned. Reach Tide Captain (36 islands charted) and carry serious coin, and any wild islet you find can become yours: protection, team, home point, a members-only warp node, and night-sky navigation home by the stars. First come, first claimed.
- đ¨ Crime that pays you into danger. Contraband only sells where the law is thin; a criminal record locks you out of safe markets and puts a bounty on your head that other players can lawfully collect. The richest smugglers are structurally pushed toward the dangerous edge of the mapâwhere the pirates already are.
- đĄ A sea that pushes back. Guardian pickets by day, drowned raiders by night, phantoms, deep terrors, boat-borne pirate crews, sea witchesâscaled by how lawless the water is. Even the safe lanes get the occasional puffer shoal, just to keep the helmsman awake.
Difficulty is geography. The waters near spawn are patrolled and calmânew and younger players can trade in peace. Danger, contraband, and PvP bounty space are all somewhere else, and going there is always a choice. That makes TradeWinds one of the few economy games that works for a family server and a cut-throat one at the same time, from the same config.
â How a session feels#
You cast off from the spawn port with three slots of cargo and a hunch: the fishing village two islands east was paying double for wheat. You row the first legâfuel is moneyâand chart a new islet on the way, one more notch toward Tide Captain. At the border curtain the warp dialog offers the crossing for 14 units of coal; you take it, because the sun is setting and drowned raiders own the night out here. The market pays out, the hold refills with cheap cod, and on the chart home you notice a red-banded island you've never dared visit is buying fish at silly prices. It would only take one quiet runâŚ
That loopâplan, sail, trade, risk a little more than last timeâis the whole game, and it does not let go.
đ§ Setup#
Vault and an economy plugin are required
All trading runs through Vault. Install Vault plus any Vault-compatible economy (EssentialsX Economy, CMI, etc.) before first launch. TradeWinds formats money itselfâwhole coins, no centsâusing the economy.currency-symbol from its config. If you want BentoBox's option, use InvSwitcher with money turned on - it's an economy for BentoBox.
- Download the TradeWinds addon and place it in
/plugins/BentoBox/addons/ - Start the serverâ
tradewinds_world(the ocean) andtradewinds_world_nether(the Interstice) generate automatically. There is deliberately no End world. - Log in and look around as Op:
/twadmin islandslists the nearest trading islands and/twadmin tpisland <#>teleports you to one. - Pick your world seed (optional, before players join): set
ocean.seedinconfig.yml. Every island position, type, and name flows from this one numberâchange it later and it is a different ocean. - Tune the economy to taste (optional): prices, boat costs, warp fuel rates, crime, and encounter tables are all in
config.ymlwith the intended defaults already in place.
Recommended companions
- InvSwitcherâkeeps inventories, health and hunger separate from your other game modes. Includes an economy.
- Bankâclaimed player islands attach to the Bank addon automatically if it is installed. Allows pooling of money between team members.
â Compatibility#
| Feature | Supported |
|---|---|
| Server | â Paper 26.2+ |
| BentoBox Version | â 3.18.0 or later |
| Java Version | â Java 25 |
| Economy | â ď¸ Vault + economy plugin required |
đŽ Commands#
The player command is /tw (or /tradewinds); the admin command is /twadmin. Bare /tw sets sailâit is the door into the ocean, and the game's one careful teleport: it returns you to the water you left, steps you to your home point if you are standing on your own island, and anywhere else at sea it tells you the bearing and distance home rather than giving you a ride. Nothing in TradeWinds teleports cargo.
The full command reference is here.
âď¸ Configuration#
Everything gameplay-shaped lives in config.yml, introduced stage by stage with comments explaining why each default is what it is. The one setting every admin should look at before launch:
ocean:
# The ocean seed. Every island position, type, security band, biome, name and
# route cost derives deterministically from this one number - share it and another
# server gets the same trading ocean. 0 means: use the world seed.
seed: 20260729
Other sections worth a skim: boats (the hull ladder and prices), travel.warp (fuel cost and misjump chance), ranks (the Seafarer ladder), claims (the price of a player island), crime (the whole law layer has a master switch), and encounters.
đ More documentation#
- The Sailor's Handbookâthe full gameplay guide: trading, boats, charts, claiming, crime, and the Interstice. Read this one to see what your players will see.
- Commandsâevery player and admin command.
- Permissionsâevery permission node and its default.
- Placeholdersârank and leaderboard placeholders for scoreboards.
Translations#
Help us keep translations accurate
Most BentoBox and addon translations are now generated with the help of AI, so the bulk of the work is already done â but AI is not perfect. What we really need from the community is error reports and corrections.
- Spotted a mistake or awkward phrasing? Open an issue or a PR on the relevant repository at bentobox.world (a short link to our GitHub org), or tell us on Discord.
- Want to add a brand-new language? Open a PR adding a new locale file to
src/main/resources/locales/in the relevant repo, or ask on Discord and we'll get you started.
| Language | Language code | Progress |
|---|---|---|
| English (United States) | en-US | 100% (Default) |