From 9bf226507fb73073f24ac3373b068b57948cf861 Mon Sep 17 00:00:00 2001 From: tastybento Date: Sat, 8 Aug 2026 12:11:05 -0700 Subject: [PATCH 1/2] docs(TradeWinds): wire the game mode into the indexes and cross-references The TradeWinds section landed in #87 but was only reachable from the nav. This links it from every page that enumerates game modes: - Homepage: add it to the hero list and the "pick a game mode" step, add a mode card, and bump the game-modes stat from 8 to 9. - Comparison: add the quick-comparison row, a "I want an economy-driven trading game" entry, and a TradeWinds column in the feature-support table. The column follows the addon's own addon.yml, which soft-depends on Border, Level, Challenges, Visit and Warps. Nether and End are marked unsupported with a footnote covering the Interstice, the deliberate absence of an End world, and the Vault requirement. - GameModes: add a "TradeWinds - Sea Trading" section in the house format. - Addons: add the row to the game mode addons table. - Translate: add the link to its translations anchor. Verified with mkdocs build; no new warnings. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01SeaqBgxyoXjLv6CZnSGErV --- docs/BentoBox/About/Addons.md | 1 + docs/BentoBox/About/GameModes.md | 8 +++++++ .../BentoBox/Translate-BentoBox-and-addons.md | 1 + docs/gamemodes/Comparison.md | 24 ++++++++++++------- docs/index.md | 10 +++++--- 5 files changed, 32 insertions(+), 12 deletions(-) diff --git a/docs/BentoBox/About/Addons.md b/docs/BentoBox/About/Addons.md index 1a3c550a..c4b62b4f 100644 --- a/docs/BentoBox/About/Addons.md +++ b/docs/BentoBox/About/Addons.md @@ -30,6 +30,7 @@ These create the world your players actually play in. Install at least one. | **Boxed** | A box that grows as you complete advancements | | **Poseidon** | Underwater survival | | **StrangerRealms** | Survival with a dangerous mirrored dimension | +| **TradeWinds** | Sea trading across an endless ocean of NPC ports (requires Vault) | See [Game Modes](GameModes.md) for full descriptions, or [compare them](../../gamemodes/Comparison.md) to help pick one. diff --git a/docs/BentoBox/About/GameModes.md b/docs/BentoBox/About/GameModes.md index 6dae9b05..d75b9828 100644 --- a/docs/BentoBox/About/GameModes.md +++ b/docs/BentoBox/About/GameModes.md @@ -75,6 +75,14 @@ Players survive in an Overworld while managing an eerie mirror dimension — the --- +### TradeWinds — Sea Trading + +Players start with a rowing boat and a little coal on an endless, procedurally generated ocean scattered with NPC trading islands. The boat is the cargo hold: buy low at one port, sell high at another, upgrade the hull, chart new islands to climb the Seafarer ranks, and eventually claim an islet of your own. Requires Vault and an economy plugin. + +**Best for:** Servers that want an economy-driven trading game — safe waters near spawn suit casual players, while smuggling, pirates, and PvP bounties wait further out. + +--- + ## Installing a Game Mode Game modes are downloaded as `.jar` files and placed in: diff --git a/docs/BentoBox/Translate-BentoBox-and-addons.md b/docs/BentoBox/Translate-BentoBox-and-addons.md index c245de34..51fdc1e0 100644 --- a/docs/BentoBox/Translate-BentoBox-and-addons.md +++ b/docs/BentoBox/Translate-BentoBox-and-addons.md @@ -67,6 +67,7 @@ island-go: "[sound:entity_experience_orb_pickup:1:1][title]Teleporting...[subtit - [Poseidon](../gamemodes/Poseidon/index.md#translations) - [SkyGrid](../gamemodes/SkyGrid/index.md#translations) - [Stranger Realms](../gamemodes/StrangerRealms/index.md#translations) +- [TradeWinds](../gamemodes/TradeWinds/index.md#translations) ## Addons diff --git a/docs/gamemodes/Comparison.md b/docs/gamemodes/Comparison.md index 9bc316c5..79116f1f 100644 --- a/docs/gamemodes/Comparison.md +++ b/docs/gamemodes/Comparison.md @@ -18,6 +18,7 @@ You can also run **more than one** at the same time — many servers offer two o | **Boxed** | Normal world | Easy–Medium | Complete advancements to grow your confined space | Medium | | **Poseidon** | Ocean | Medium | Survive entirely underwater | Medium | | **StrangerRealms** | Overworld + Upside Down | Medium–Hard | Claim land while managing a dangerous mirror dimension | Medium–High | +| **TradeWinds** | Sea (endless trading ocean) | Easy–Hard (by region) | Sail between NPC trading islands, buying low and selling high | Medium | --- @@ -47,26 +48,31 @@ You can also run **more than one** at the same time — many servers offer two o ### I want a story-inspired experience with complex mechanics **StrangerRealms** — The Upside Down mirror dimension adds a layer of strategy. Better suited to players who are comfortable with Minecraft and ready for something more involved. +### I want an economy-driven trading game +**TradeWinds** — Buy low and sell high across an endless procedurally generated ocean of NPC trading ports. Difficulty is geography: the waters near spawn are patrolled and calm, while contraband, pirates, and PvP bounty space are all further out — so it works for a family server and a cut-throat one at the same time. Requires Vault and an economy plugin. + --- ## Feature Support by Game Mode Most BentoBox addons work with all game modes. A few have specific compatibility requirements. -| Feature | BSkyBlock | AOneBlock | AcidIsland | CaveBlock | SkyGrid | Boxed | Poseidon | StrangerRealms | -|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| -| Level addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Challenges | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Warps | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| InvSwitcher | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Border addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌* | -| Nether world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌** | -| End world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Feature | BSkyBlock | AOneBlock | AcidIsland | CaveBlock | SkyGrid | Boxed | Poseidon | StrangerRealms | TradeWinds | +|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| +| Level addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Challenges | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Warps | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| InvSwitcher | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Border addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌* | ✅ | +| Nether world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌** | ❌*** | +| End world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌*** | \* StrangerRealms has its own built-in border system — do not use the Border addon with it. \*\* StrangerRealms replaces the Nether with the Upside Down dimension. +\*\*\* TradeWinds replaces the Nether with the Interstice (a hostile nether sea reached by warp misjumps) and deliberately has no End world. TradeWinds also requires Vault plus an economy plugin. + --- ## Running Multiple Game Modes diff --git a/docs/index.md b/docs/index.md index a2eaf705..b3f0a3d1 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,7 +11,7 @@ hide:

docs.bentobox.world

Your players are going to have a great time.

-

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, SkyGrid, Boxed, Poseidon, Stranger Realms — all running side by side on your Paper server, each with its own world, rules, and progression. One plugin. Drop in the game modes you want.

+

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, SkyGrid, Boxed, Poseidon, Stranger Realms, TradeWinds — all running side by side on your Paper server, each with its own world, rules, and progression. One plugin. Drop in the game modes you want.

First 30 minutes → @@ -30,7 +30,7 @@ hide:
addons
-
8
+
9
game modes
@@ -62,7 +62,7 @@ hide: 5 min

Pick a game mode

-

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, Boxed, Poseidon — pick one to start.

+

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, Boxed, Poseidon, TradeWinds — pick one to start.

Compare game modes →
@@ -116,6 +116,10 @@ hide: StrangerRealmsmystery + + + TradeWindssea trading +
From 028eec3b66a28a5f101309103f14da82386ea745 Mon Sep 17 00:00:00 2001 From: tastybento Date: Sun, 9 Aug 2026 12:32:35 -0700 Subject: [PATCH 2/2] docs(ChunkBlock): wire the game mode into the indexes and cross-references The ChunkBlock section landed in #90 but was only reachable from the nav. This links it from every page that enumerates game modes: - Homepage: add it to the hero list and the "pick a game mode" step, add a mode card next to AOneBlock, and bump the game-modes stat from 9 to 10. - Comparison: add the quick-comparison row, an "I want the one-block loop with a reason to keep levelling" entry, and a ChunkBlock column in the feature-support table. Level is marked as required and the Nether/End cells note that both are generated off by default, per the addon's own config. - GameModes: add a "ChunkBlock - One Block in a Walled Chunk" section in the house format. - Addons: add the row to the game mode addons table. - Translate: add the link to its translations anchor. Verified with mkdocs build; the only warnings are pre-existing GitHub rate-limit 403s from the translations macro. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01NbnUebf6zh8aW9UmoBv7h6 --- docs/BentoBox/About/Addons.md | 1 + docs/BentoBox/About/GameModes.md | 8 ++++++ .../BentoBox/Translate-BentoBox-and-addons.md | 1 + docs/gamemodes/Comparison.md | 26 ++++++++++++------- docs/index.md | 10 ++++--- 5 files changed, 34 insertions(+), 12 deletions(-) diff --git a/docs/BentoBox/About/Addons.md b/docs/BentoBox/About/Addons.md index c4b62b4f..2863e819 100644 --- a/docs/BentoBox/About/Addons.md +++ b/docs/BentoBox/About/Addons.md @@ -24,6 +24,7 @@ These create the world your players actually play in. Install at least one. |---|---| | **BSkyBlock** | Classic Skyblock — floating island in the sky | | **AOneBlock** | Start from a single magical regenerating block | +| **ChunkBlock** | One block in a walled chunk — spend island levels to claim more (requires Level) | | **AcidIsland** | Skyblock where the ocean is acid | | **CaveBlock** | Survival in a solid underground world | | **SkyGrid** | Scattered single blocks across the void | diff --git a/docs/BentoBox/About/GameModes.md b/docs/BentoBox/About/GameModes.md index d75b9828..99f551a8 100644 --- a/docs/BentoBox/About/GameModes.md +++ b/docs/BentoBox/About/GameModes.md @@ -27,6 +27,14 @@ Players start with a single magical block floating in the void. Every time they --- +### ChunkBlock — One Block in a Walled Chunk + +Players start on the same magical regenerating block as AOneBlock, but the world is a single 16×16 chunk with a border nothing can cross — not walking, flying, pearling or digging. Island level is the currency for territory: build the level up, walk to the wall and punch it in the direction you want, and the next chunk opens. Lose levels and the newest chunks re-lock (builds untouched) until the levels come back. Requires the [Level](../../addons/Level/index.md) addon. + +**Best for:** Servers that want the one-block loop with a hard reason to keep levelling, and expansion the players earn a chunk at a time. + +--- + ### AcidIsland — Survival in Acid Similar to Skyblock, but the ocean surrounding the islands is filled with acid that damages players. Swimming is dangerous, so players must build carefully and avoid falling in. diff --git a/docs/BentoBox/Translate-BentoBox-and-addons.md b/docs/BentoBox/Translate-BentoBox-and-addons.md index 51fdc1e0..3863f4da 100644 --- a/docs/BentoBox/Translate-BentoBox-and-addons.md +++ b/docs/BentoBox/Translate-BentoBox-and-addons.md @@ -64,6 +64,7 @@ island-go: "[sound:entity_experience_orb_pickup:1:1][title]Teleporting...[subtit - [Boxed](../gamemodes/Boxed/index.md#translations) - [BSkyBlock](../gamemodes/BSkyBlock/index.md#translations) - [CaveBlock](../gamemodes/CaveBlock/index.md#translations) +- [ChunkBlock](../gamemodes/ChunkBlock/index.md#translations) - [Poseidon](../gamemodes/Poseidon/index.md#translations) - [SkyGrid](../gamemodes/SkyGrid/index.md#translations) - [Stranger Realms](../gamemodes/StrangerRealms/index.md#translations) diff --git a/docs/gamemodes/Comparison.md b/docs/gamemodes/Comparison.md index 79116f1f..f56fb1fa 100644 --- a/docs/gamemodes/Comparison.md +++ b/docs/gamemodes/Comparison.md @@ -12,6 +12,7 @@ You can also run **more than one** at the same time — many servers offer two o |---|---|---|---|---| | **BSkyBlock** | Sky (floating islands) | Medium | Expand from a tiny island in the void | Medium | | **AOneBlock** | Sky (void) | Medium | Mine a single magical block that never runs out | Low–Medium | +| **ChunkBlock** | Sky (void, one chunk) | Medium | Mine the magic block and spend island levels to punch out the walls | Low–Medium | | **AcidIsland** | Sea (acid ocean) | Medium–Hard | Skyblock with dangerous acid water | Medium | | **CaveBlock** | Underground | Medium | Carve out space in a solid stone world | Medium | | **SkyGrid** | Sky (scattered blocks) | Hard | Collect resources from a grid of single blocks | Low | @@ -30,6 +31,9 @@ You can also run **more than one** at the same time — many servers offer two o ### I want something fresh but still approachable **AOneBlock** — The concept (one magical block) is easy to explain and immediately engaging. The built-in phase progression keeps players motivated for a long time. +### I want the one-block loop with a reason to keep levelling +**ChunkBlock** — The same magic block as AOneBlock (phase files are interchangeable), but the world is one 16×16 chunk behind a border nothing can cross. Island level is the currency: build your level up, walk to the wall, and punch it in the direction you want to grow. Lose levels and the newest chunks re-lock, builds untouched, until you earn them back — or switch that off in the config if you want territory to be a ratchet. Requires the [Level](../addons/Level/index.md) addon. + ### I want Skyblock but harder **AcidIsland** — Same feel as BSkyBlock but falling in the ocean is genuinely dangerous. Good for players who found regular Skyblock too easy. @@ -57,15 +61,15 @@ You can also run **more than one** at the same time — many servers offer two o Most BentoBox addons work with all game modes. A few have specific compatibility requirements. -| Feature | BSkyBlock | AOneBlock | AcidIsland | CaveBlock | SkyGrid | Boxed | Poseidon | StrangerRealms | TradeWinds | -|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| -| Level addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Challenges | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Warps | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| InvSwitcher | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| Border addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌* | ✅ | -| Nether world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌** | ❌*** | -| End world | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌*** | +| Feature | BSkyBlock | AOneBlock | ChunkBlock | AcidIsland | CaveBlock | SkyGrid | Boxed | Poseidon | StrangerRealms | TradeWinds | +|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| +| Level addon | ✅ | ✅ | ⚠️**** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Challenges | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Warps | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| InvSwitcher | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| Border addon | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌* | ✅ | +| Nether world | ✅ | ✅ | ⚠️***** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌** | ❌*** | +| End world | ✅ | ✅ | ⚠️***** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌*** | \* StrangerRealms has its own built-in border system — do not use the Border addon with it. @@ -73,6 +77,10 @@ Most BentoBox addons work with all game modes. A few have specific compatibility \*\*\* TradeWinds replaces the Nether with the Interstice (a hostile nether sea reached by warp misjumps) and deliberately has no End world. TradeWinds also requires Vault plus an economy plugin. +\*\*\*\* ChunkBlock **requires** the Level addon — island level is the currency used to claim chunks, and ChunkBlock disables itself if Level is missing. + +\*\*\*\*\* ChunkBlock generates the Nether and the End off by default. Enable either one and it gets its own centre chunk and the same level-driven claim rules; the magic block only ever exists in the overworld. + --- ## Running Multiple Game Modes diff --git a/docs/index.md b/docs/index.md index b3f0a3d1..b9754b58 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,7 +11,7 @@ hide:

docs.bentobox.world

Your players are going to have a great time.

-

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, SkyGrid, Boxed, Poseidon, Stranger Realms, TradeWinds — all running side by side on your Paper server, each with its own world, rules, and progression. One plugin. Drop in the game modes you want.

+

BSkyBlock, AOneBlock, ChunkBlock, AcidIsland, CaveBlock, SkyGrid, Boxed, Poseidon, Stranger Realms, TradeWinds — all running side by side on your Paper server, each with its own world, rules, and progression. One plugin. Drop in the game modes you want.

First 30 minutes → @@ -30,7 +30,7 @@ hide:
addons
-
9
+
10
game modes
@@ -62,7 +62,7 @@ hide: 5 min

Pick a game mode

-

BSkyBlock, AOneBlock, AcidIsland, CaveBlock, Boxed, Poseidon, TradeWinds — pick one to start.

+

BSkyBlock, AOneBlock, ChunkBlock, AcidIsland, CaveBlock, Boxed, Poseidon, TradeWinds — pick one to start.

Compare game modes →
@@ -96,6 +96,10 @@ hide: AOneBlockone block + + + ChunkBlockone block · walled + CaveBlockunderground