# Border Quest<\/p>\n
A **server-side Fabric mod** for Minecraft 1.21 that turns your world border into a cooperative progression challenge.
\nPlayers collect resources, donate them to **altars**, and unlock an ever-growing world \u2014 stage by stage.<\/p>\n
—<\/p>\n
## Features<\/p>\n
| Feature | Description |
\n|—|—|
\n| **Progressive world border** | Starts small and expands as players complete stages |
\n| **Altar system** | Donate items by right-clicking any altar block |
\n| **Stage rewards** | Give items, potion effects or XP to all players on stage completion |
\n| **Dimension locks** | Nether & End are gated behind configurable stages |
\n| **Donation leaderboard** | `\/bq ladder` shows the top contributors |
\n| **Altar particles** | Visual END_ROD particle effect on every altar |
\n| **Chat announcements** | Server-wide broadcast on large donations |
\n| **HUD sidebar** | Tab-list header displays current objective |
\n| **Map integrations** | BlueMap, Dynmap, JourneyMap, Xaero’s Minimap & World Map |
\n| **Discord webhook** | Sends a message on every stage completion |
\n| **Fully configurable** | All stages, radii and behaviour tunable via JSON |<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Dependency | Version | Required? |
\n|—|—|—|
\n| Minecraft | 1.21.x | \u2705 |
\n| Fabric Loader | \u2265 0.14.21 | \u2705 |
\n| Fabric API | any | \u2705 |
\n| BlueMap | any | Optional |
\n| Dynmap (Fabric) | any | Optional |
\n| JourneyMap | any | Optional (singleplayer \/ LAN) |
\n| Xaero’s Minimap | any | Optional (singleplayer \/ LAN) |
\n| Xaero’s World Map | any | Optional (singleplayer \/ LAN) |<\/p>\n
> **Server-side only.** Clients do not need to install this mod.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Drop `border-quest-mod-x.x.x.jar` into your server’s `mods\/` folder alongside Fabric API.
\n2. Start the server once \u2014 `config\/borderquest.json` is generated automatically.
\n3. Edit the config to suit your server, then run `\/bq reload`.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands start with `\/bq` (alias available via any registered alias).<\/p>\n
### Player commands<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/bq` or `\/bq status` | Show current stage, objective and progress |
\n| `\/bq submit` | Donate all eligible items from your inventory |
\n| `\/bq ladder` | Show the top 10 donors |<\/p>\n
### Operator commands (permission level 2)<\/p>\n
| Command | Description | > To **donate**, right-click any altar block while holding items. —<\/p>\n ## Configuration<\/p>\n File location: `config\/borderquest.json`<\/p>\n “`jsonc \/\/ Duration of the celebration fireworks on stage completion (ticks, 20 = 1s) \/\/ Damage per second while a player is outside the border \/\/ Distance (blocks) at which the border warning is shown \/\/ Nether coordinate scale factor (Nether border = Overworld radius \/ netherScale) \/\/ Altar particles ———————————————————–<\/p>\n “altarParticlesEnabled”: true, \/\/ Donation announcements —————————————————-<\/p>\n \/\/ Broadcast a message to all players when a single donation reaches this count \/\/ Dimension locks ———————————————————–<\/p>\n \/\/ Prevent players from entering a dimension until the required stage is reached \/\/ Discord webhook ———————————————————–<\/p>\n “discordEnabled”: false, \/\/ Stages ——————————————————————–<\/p>\n “stages”: [ ### Stage anatomy<\/p>\n | Field | Type | Description | **Built-in categories**: `logs`, `planks`, `wool`, `sand`, `stone` \u2014 resolved to the most common variants found in the spawn biome.<\/p>\n ### Reward types<\/p>\n | `type` | Required fields | Example | —<\/p>\n ## Altar setup<\/p>\n Altars can be **any block** \u2014 a beacon, a chest, a custom banner \u2014 whatever fits your server’s theme.<\/p>\n 1. Place the block in-world. To remove an altar: look at it and run `\/bq removealtar`.<\/p>\n > Altar positions are saved in `world\/data\/borderquest_state.json` and survive restarts.<\/p>\n —<\/p>\n ## Map integrations<\/p>\n ### BlueMap<\/p>\n Requires **BlueMap** installed on the server. Markers rebuild automatically when BlueMap reloads.<\/p>\n ### Dynmap<\/p>\n Requires **Dynmap for Fabric** installed on the server. ### JourneyMap & Xaero’s Minimap \/ World Map<\/p>\n > **Singleplayer & LAN only.** These mods run client-side and are not available on a dedicated server’s classpath.<\/p>\n When running in **singleplayer or LAN**, if JourneyMap, Xaero’s Minimap, or Xaero’s World Map is installed: The integration uses reflection \u2014 no additional configuration is needed.<\/p>\n —<\/p>\n ## Discord webhook<\/p>\n 1. Create a webhook in your Discord server: **Channel Settings \u2192 Integrations \u2192 Webhooks**. A message is sent automatically each time a stage is completed.<\/p>\n —<\/p>\n ## Dimension locks<\/p>\n By default: Attempting to enter a locked dimension cancels the teleport and displays a red message. —<\/p>\n ## Saved state<\/p>\n The game state (current stage, submitted items, altar list, donor stats) is saved in:<\/p>\n “` Back up this file if you want to preserve progress between map resets.<\/p>\n —<\/p>\n ## Building from source<\/p>\n “`bash **Requirements:** Java 21, internet access (to download Fabric Loom and BlueMap API).<\/p>\n Dependencies at a glance:<\/p>\n | Artifact | Scope | Purpose | —<\/p>\n ## License<\/p>\n MIT \u2014 see [LICENSE](LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":" A Minecraft Fabric mod that shrinks the size of the world. Players must complete objectives to gradually expand it. Fully customizable.<\/p>\n","protected":false},"featured_media":33827,"template":"","meta":{"_minecraft_slug":"border-quest","_minecraft_project_id":"rnhBP8JZ","_minecraft_author":"hirochifaa","_minecraft_license":"MIT","_minecraft_downloads":149,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"border-quest.zip","_minecraft_size_bytes":202257,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T20:51:30.779174Z","_minecraft_date_created":"2026-03-25T02:45:29.852836Z","_minecraft_date_modified":"2026-05-09T12:36:37.862179Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/border-quest","_minecraft_icon_attachment_id":33827,"_minecraft_imported_at":"2026-06-01T15:54:32+00:00","_minecraft_import_hash":"20b2bc0664273b71ada76db09fd8a890","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,89,866,867,92],"mod_loader":[99],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,163],"class_list":["post-33826","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-game-mechanics","mod_category-minigame","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `\/bq setaltar` | Register the block you are looking at as an altar |
\n| `\/bq setaltar
\n| `\/bq removealtar` | Remove the looked-at block from the altar list |
\n| `\/bq skip` | Force-advance to the next stage without filling the objective |
\n| `\/bq reset` | Reset the game to stage 1 |
\n| `\/bq reload` | Reload `borderquest.json` and the saved state without restarting |<\/p>\n
\n> `\/bq submit` works from anywhere and scans your entire inventory.<\/p>\n
\n{
\n \/\/ General ——————————————————————-<\/p>\n
\n “celebrationDurationTicks”: 200,<\/p>\n
\n “borderDamagePerBlock”: 0.2,<\/p>\n
\n “borderWarningBlocks”: 5,<\/p>\n
\n “netherScale”: 8.0,<\/p>\n
\n \/\/ How often particles spawn, in ticks (20 = once per second)
\n “altarParticlePeriodTicks”: 20,<\/p>\n
\n “donationAnnouncementsEnabled”: true,
\n “donationAnnounceMinItems”: 16,<\/p>\n
\n “worldLocks”: [
\n { “worldId”: “minecraft:the_nether”, “requiredStage”: 5 },
\n { “worldId”: “minecraft:the_end”, “requiredStage”: 7 }
\n ],<\/p>\n
\n “discordWebhookUrl”: “https:\/\/discord.com\/api\/webhooks\/YOUR_ID\/YOUR_TOKEN”,
\n “discordUsername”: “Border Quest”,
\n “discordAvatarUrl”: “”, \/\/ Leave empty to use the default webhook avatar<\/p>\n
\n {
\n “borderRadius”: 10,
\n “title”: “Clear the area”,
\n \/\/ Fixed items required
\n “requirements”: [
\n { “itemId”: “minecraft:cobblestone”, “count”: 64 }
\n ],
\n \/\/ Biome-resolved categories (the mod picks the right log type automatically)
\n “categoryRequirements”: [
\n { “category”: “logs”, “count”: 64 }
\n ],
\n \/\/ Rewards distributed to ALL online players on completion
\n “rewards”: []
\n },
\n {
\n “borderRadius”: 25,
\n “title”: “First steps toward civilisation”,
\n “requirements”: [
\n { “itemId”: “minecraft:iron_ingot”, “count”: 32 },
\n { “itemId”: “minecraft:bread”, “count”: 32 }
\n ],
\n “categoryRequirements”: [],
\n “rewards”: [
\n \/\/ Give 3 bread to every online player
\n { “type”: “item”, “itemId”: “minecraft:bread”, “count”: 3 },
\n \/\/ Apply Haste I for 30 s
\n { “type”: “effect”, “effectId”: “minecraft:haste”, “duration”: 600, “amplifier”: 0 },
\n \/\/ Give 50 XP points
\n { “type”: “xp”, “amount”: 50 }
\n ]
\n }
\n \/\/ … add as many stages as you like
\n \/\/ The LAST stage represents total freedom (use borderRadius: 29999984)
\n ]
\n}
\n“`<\/p>\n
\n|—|—|—|
\n| `borderRadius` | double | Half the side length of the square border (diameter = radius \u00d7 2) |
\n| `title` | string | Displayed in chat and the tab-list sidebar |
\n| `requirements` | list | Specific items required \u2014 `itemId` + `count` |
\n| `categoryRequirements` | list | Biome-adaptive requirements \u2014 `category` + `count` |
\n| `rewards` | list | Rewards given to all online players on stage validation |<\/p>\n
\n|—|—|—|
\n| `”item”` | `itemId`, `count` | `{ “type”: “item”, “itemId”: “minecraft:diamond”, “count”: 2 }` |
\n| `”effect”` | `effectId`, `duration` (ticks), `amplifier` (0 = level I) | `{ “type”: “effect”, “effectId”: “minecraft:speed”, “duration”: 400, “amplifier”: 1 }` |
\n| `”xp”` | `amount` | `{ “type”: “xp”, “amount”: 100 }` |<\/p>\n
\n2. Look at it and run `\/bq setaltar` (optionally `\/bq setaltar Altar du Spawn`).
\n3. Players can now right-click the block to donate items.<\/p>\n
\nThe mod automatically renders:
\n– A **green rectangle** showing the current border extent on the overworld map.
\n– A **POI marker** for each altar (with its display name if set).<\/p>\n
\nSame markers as BlueMap \u2014 rendered via reflection, no extra dependency needed.<\/p>\n
\n– A **waypoint** is created for each altar when it is registered.
\n– The waypoint is removed when the altar is removed.
\n– Border shapes are not supported (client-side map limitation).<\/p>\n
\n2. Copy the URL and paste it in `borderquest.json`:
\n “`json
\n “discordEnabled”: true,
\n “discordWebhookUrl”: “https:\/\/discord.com\/api\/webhooks\/123456789\/abc…”,
\n “discordUsername”: “Border Quest”,
\n “discordAvatarUrl”: “”
\n “`
\n3. Run `\/bq reload`.<\/p>\n
\n– **The Nether** is locked until stage 5.
\n– **The End** is locked until stage 7.<\/p>\n
\nCustomise or remove locks in `borderquest.json` under `worldLocks`.<\/p>\n
\n
\n“`<\/p>\n
\ngit clone
\ncd border-quest-mod
\n.\/gradlew build
\n# Output: build\/libs\/border-quest-mod-x.x.x.jar
\n“`<\/p>\n
\n|—|—|—|
\n| `net.fabricmc.fabric-api` | `modImplementation` | Fabric API |
\n| `de.bluecolored:bluemap-api:2.7.7` | `compileOnly` | BlueMap markers at compile time |
\n| Dynmap, JourneyMap, Xaero’s | none | Integrated via reflection \u2014 no compile dependency |<\/p>\n