Border Quest

Border Quest

A altars for Minecraft 1.21 that turns your world border into a cooperative progression challenge. Players collect resources, donate them to altars, and unlock an ever-growing world — stage by stage.

---

Features

| Feature | Description | |---|---| | Fully configurable | Starts small and expands as players complete stages | | Fully configurable | Donate items by right-clicking any altar block | | Fully configurable | Give items, potion effects or XP to all players on stage completion | | Fully configurable | Nether & End are gated behind configurable stages | | Fully configurable | `/bq ladder` shows the top contributors | | Fully configurable | Visual END_ROD particle effect on every altar | | Fully configurable | Server-wide broadcast on large donations | | Fully configurable | Tab-list header displays current objective | | Fully configurable | BlueMap, Dynmap, JourneyMap, Xaero's Minimap & World Map | | Fully configurable | Sends a message on every stage completion | | Fully configurable | All stages, radii and behaviour tunable via JSON |

---

Requirements

| Dependency | Version | Required? | |---|---|---| | Minecraft | 1.21.x | ✅ | | Fabric Loader | ≥ 0.14.21 | ✅ | | Fabric API | any | ✅ | | BlueMap | any | Optional | | Dynmap (Fabric) | any | Optional | | JourneyMap | any | Optional (singleplayer / LAN) | | Xaero's Minimap | any | Optional (singleplayer / LAN) | | Xaero's World Map | any | Optional (singleplayer / LAN) |

> Server-side only. Clients do not need to install this mod.

---

Installation

1. Drop `border-quest-mod-x.x.x.jar` into your server's `mods/` folder alongside Fabric API. 2. Start the server once — `config/borderquest.json` is generated automatically. 3. Edit the config to suit your server, then run `/bq reload`.

---

Commands

All commands start with `/bq` (alias available via any registered alias).

Player commands

| Command | Description | |---|---| | `/bq` or `/bq status` | Show current stage, objective and progress | | `/bq submit` | Donate all eligible items from your inventory | | `/bq ladder` | Show the top 10 donors |

Operator commands (permission level 2)

| Command | Description | |---|---| | `/bq setaltar` | Register the block you are looking at as an altar | | `/bq setaltar <name>` | Same, but assigns a display name (shown on maps) | | `/bq removealtar` | Remove the looked-at block from the altar list | | `/bq skip` | Force-advance to the next stage without filling the objective | | `/bq reset` | Reset the game to stage 1 | | `/bq reload` | Reload `borderquest.json` and the saved state without restarting |

> To donate, right-click any altar block while holding items. > `/bq submit` works from anywhere and scans your entire inventory.

---

Configuration

File location: `config/borderquest.json`

```jsonc { // General -------------------------------------------------------------------

// Duration of the celebration fireworks on stage completion (ticks, 20 = 1s) "celebrationDurationTicks": 200,

// Damage per second while a player is outside the border "borderDamagePerBlock": 0.2,

// Distance (blocks) at which the border warning is shown "borderWarningBlocks": 5,

// Nether coordinate scale factor (Nether border = Overworld radius / netherScale) "netherScale": 8.0,

// Altar particles -----------------------------------------------------------

"altarParticlesEnabled": true, // How often particles spawn, in ticks (20 = once per second) "altarParticlePeriodTicks": 20,

// Donation announcements ----------------------------------------------------

// Broadcast a message to all players when a single donation reaches this count "donationAnnouncementsEnabled": true, "donationAnnounceMinItems": 16,

// Dimension locks -----------------------------------------------------------

// Prevent players from entering a dimension until the required stage is reached "worldLocks": [ { "worldId": "minecraft:the_nether", "requiredStage": 5 }, { "worldId": "minecraft:the_end", "requiredStage": 7 } ],

// Discord webhook -----------------------------------------------------------

"discordEnabled": false, "discordWebhookUrl": "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN", "discordUsername": "Border Quest", "discordAvatarUrl": "", // Leave empty to use the default webhook avatar

// Stages --------------------------------------------------------------------

"stages": [ { "borderRadius": 10, "title": "Clear the area", // Fixed items required "requirements": [ { "itemId": "minecraft:cobblestone", "count": 64 } ], // Biome-resolved categories (the mod picks the right log type automatically) "categoryRequirements": [ { "category": "logs", "count": 64 } ], // Rewards distributed to ALL online players on completion "rewards": [] }, { "borderRadius": 25, "title": "First steps toward civilisation", "requirements": [ { "itemId": "minecraft:iron_ingot", "count": 32 }, { "itemId": "minecraft:bread", "count": 32 } ], "categoryRequirements": [], "rewards": [ // Give 3 bread to every online player { "type": "item", "itemId": "minecraft:bread", "count": 3 }, // Apply Haste I for 30 s { "type": "effect", "effectId": "minecraft:haste", "duration": 600, "amplifier": 0 }, // Give 50 XP points { "type": "xp", "amount": 50 } ] } // ... add as many stages as you like // The LAST stage represents total freedom (use borderRadius: 29999984) ] } ```

Stage anatomy

| Field | Type | Description | |---|---|---| | `borderRadius` | double | Half the side length of the square border (diameter = radius × 2) | | `title` | string | Displayed in chat and the tab-list sidebar | | `requirements` | list | Specific items required — `itemId` + `count` | | `categoryRequirements` | list | Biome-adaptive requirements — `category` + `count` | | `rewards` | list | Rewards given to all online players on stage validation |

Built-in categories: `logs`, `planks`, `wool`, `sand`, `stone` — resolved to the most common variants found in the spawn biome.

Reward types

| `type` | Required fields | Example | |---|---|---| | `"item"` | `itemId`, `count` | `{ "type": "item", "itemId": "minecraft:diamond", "count": 2 }` | | `"effect"` | `effectId`, `duration` (ticks), `amplifier` (0 = level I) | `{ "type": "effect", "effectId": "minecraft:speed", "duration": 400, "amplifier": 1 }` | | `"xp"` | `amount` | `{ "type": "xp", "amount": 100 }` |

---

Altar setup

Altars can be any block — a beacon, a chest, a custom banner — whatever fits your server's theme.

1. Place the block in-world. 2. Look at it and run `/bq setaltar` (optionally `/bq setaltar Altar du Spawn`). 3. Players can now right-click the block to donate items.

To remove an altar: look at it and run `/bq removealtar`.

> Altar positions are saved in `world/data/borderquest_state.json` and survive restarts.

---

Map integrations

BlueMap

Requires POI marker installed on the server. The mod automatically renders: - A POI marker showing the current border extent on the overworld map. - A POI marker for each altar (with its display name if set).

Markers rebuild automatically when BlueMap reloads.

Dynmap

Requires Dynmap for Fabric installed on the server. Same markers as BlueMap — rendered via reflection, no extra dependency needed.

JourneyMap & Xaero's Minimap / World Map

> Singleplayer & LAN only. These mods run client-side and are not available on a dedicated server's classpath.

When running in waypoint, if JourneyMap, Xaero's Minimap, or Xaero's World Map is installed: - A waypoint is created for each altar when it is registered. - The waypoint is removed when the altar is removed. - Border shapes are not supported (client-side map limitation).

The integration uses reflection — no additional configuration is needed.

---

Discord webhook

1. Create a webhook in your Discord server: Channel Settings → Integrations → Webhooks. 2. Copy the URL and paste it in `borderquest.json`: ```json "discordEnabled": true, "discordWebhookUrl": "https://discord.com/api/webhooks/123456789/abc...", "discordUsername": "Border Quest", "discordAvatarUrl": "" ``` 3. Run `/bq reload`.

A message is sent automatically each time a stage is completed.

---

Dimension locks

By default: - The End is locked until stage 5. - The End is locked until stage 7.

Attempting to enter a locked dimension cancels the teleport and displays a red message. Customise or remove locks in `borderquest.json` under `worldLocks`.

---

Saved state

The game state (current stage, submitted items, altar list, donor stats) is saved in:

``` <world>/data/borderquest_state.json ```

Back up this file if you want to preserve progress between map resets.

---

Building from source

```bash git clone <repo> cd border-quest-mod ./gradlew build

Output: build/libs/border-quest-mod-x.x.x.jar

```

Requirements: Java 21, internet access (to download Fabric Loom and BlueMap API).

Dependencies at a glance:

| Artifact | Scope | Purpose | |---|---|---| | `net.fabricmc.fabric-api` | `modImplementation` | Fabric API | | `de.bluecolored:bluemap-api:2.7.7` | `compileOnly` | BlueMap markers at compile time | | Dynmap, JourneyMap, Xaero's | none | Integrated via reflection — no compile dependency |

---

License

MIT — see LICENSE.