Skip to content
Return to Projects
Case Study

IceLegends SMP

A vanilla-first Romanian Minecraft SMP built for clean 3–4 month seasons.

The Problem

Running a community SMP means balancing plugin depth against vanilla feel, managing a world-reset cycle, and keeping operations simple enough for a solo admin. IceLegends SMP solves this with 11 carefully chosen plugins, strict feature gating per a "vanilla-first" principle, and fully automated backups and world resets.

My Role

Designed, configured, and deployed solo — server architecture, 11-plugin selection and configuration, LuckPerms permission model, economy and nation design, Docker infrastructure, and Cloudflare Tunnel ingress for Dynmap.

Highlights

  • PaperMC 1.21 on Docker with a hard 11-plugin cap — every plugin is justified and none are redundant
  • Towny nations with seasonal quests (Quests + Citizens NPCs) and a single manually-spawned MythicMobs boss per season
  • AureliumSkills passive bonuses only — active abilities disabled to preserve vanilla combat (P-01)
  • DiscordSRV bridge logs every death, join, and chat event to dedicated Discord channels in real time
  • Daily automated backups with 7-day retention; resource world resets every Monday at 05:00 via cron

Stack

PaperMC 1.21DockerCloudflare TunnelLuckPermsTownyAureliumSkillsMythicMobsDiscordSRVDynmap

Constraints

  • Solo admin — every operation must complete in under 10 minutes (P-02).
  • Vanilla-first (P-01): if any plugin disappeared tomorrow, the game must continue unchanged.
  • 11-plugin hard cap — every addition must displace something or prove unique, irreplaceable value.

System Architecture

Edge
Cloudflare Tunnel (Dynmap web map)
TCP :25565 open (Minecraft clients)
Runtime
Docker + docker-compose
itzg/minecraft-server image
Core
PaperMC 1.21
Vault
LuckPerms
EssentialsX
CoreProtect
Gameplay
Towny
AureliumSkills
ShopGUI+
Quests + Citizens
MythicMobs
Multiverse-Core
Ops
DiscordSRV bridge
Daily backup cron (04:00)
Weekly world reset cron (Mon 05:00)

Key Trade-offs

The decisions worth defending — what I chose, what I turned down, and why.

Plugin count cap

Chose

Hard cap at 11 plugins

Rejected

Unlimited plugin stack

Each plugin is a maintenance surface and a potential conflict point. The cap forces prioritisation and keeps the dependency graph legible for a solo admin.

Public ingress for Dynmap

Chose

Cloudflare Tunnel (no open ports)

Rejected

Expose :8123 directly via UFW

No origin IP exposure, free DDoS protection, and zero firewall rule maintenance — the same pattern used by the IceLegends portfolio site.

AureliumSkills scope

Chose

Passive bonuses only, active abilities disabled

Rejected

Full AureliumSkills feature set including active combat abilities

Active abilities alter vanilla combat — a direct violation of P-01. Passive bonuses reward playtime additively without changing the combat model.

Season lifecycle

Chose

Full world reset every 3–4 months

Rejected

Incremental map expansion with no reset

Resets keep the world fresh, prevent terrain exhaustion, and give every new player an equal start — critical for community health in a small SMP.

What I'd Do Differently

An honest retrospective — the stuff I'd change with more time, more users, or a second pass.

  1. 1Add a staging compose stack so plugin updates can be tested before touching the live season — one bad update cost several hours of rollback work.
  2. 2Move backup storage off-site from day one; local-only archives are a single hardware failure away from a full season loss.
  3. 3Wire Dynmap as a named Docker service rather than relying on the host port, so the Cloudflare Tunnel config survives container IP reassignment on restart.

Technical Deep-Dive

Architecture, specifications, and implementation details.

02 — Plugin Architecture

"

11 plugins, 3 layers, zero compromise on vanilla gameplay

#Dependency Graph

                   ┌──────────────────┐
                   │   PaperMC API    │  ← all plugins depend on this
                   └────────┬─────────┘
          ┌─────────────────┼──────────────────┐
          ▼                 ▼                  ▼
   ┌────────────┐    ┌───────────┐    ┌──────────────┐
   │   Vault    │    │ LuckPerms │    │ EssentialsX  │
   │ (Economy   │    │(Permissions    │ (Commands)   │
   │  Bridge)   │    │  Engine)  │    └──────────────┘
   └─────┬──────┘    └─────┬─────┘
         │                 │
   ┌─────┴──────┐          └──── (all plugins inherit permissions)
   │            │
   ▼            ▼
┌────────┐  ┌────────┐
│ShopGUI+│  │ Towny  │──── Dynmap (nation borders on map)
└────────┘  └────────┘

┌──────────┐   ┌─────────┐   ┌────────────────┐
│ Citizens │──▶│ Quests  │   │ AureliumSkills │
│  (NPCs)  │   │         │   │ (Passive only) │
└──────────┘   └─────────┘   └────────────────┘

┌────────────┐  ┌────────────┐  ┌───────────────┐  ┌──────────────────┐
│ MythicMobs │  │ DiscordSRV │  │  CoreProtect  │  │ Multiverse-Core  │
│ (Boss AI)  │  │  (Bridge)  │  │ (Anti-Grief)  │  │ (World Manager)  │
└────────────┘  └────────────┘  └───────────────┘  └──────────────────┘

#Plugin Specification

##Layer 1 — Invisible Foundation

PluginRoleVanilla ImpactPriority
PaperMC 1.21.xServer core — async chunks, anti-xray, performance patchesZeroCRITICAL
VaultEconomy + permissions bridge. Required by ShopGUI+ZeroCRITICAL
LuckPermsDeny-by-default permission engine. 2 groups: Jucător + StaffZeroHIGH
CoreProtectBlock-level event logging + rollback per player/zoneZeroHIGH
EssentialsX/home /tpa /spawn only — everything else disabledMinimalHIGH

##Layer 2 — Vanilla+

PluginRoleVanilla ImpactPriority
AureliumSkillsPassive skill XP from normal play. Active abilities DISABLEDLowMEDIUM
DiscordSRVChat bridge + death/join events. No gameplay impactZeroLOW
DynmapLive web map via Cloudflare TunnelZeroLOW

##Layer 3 — Uniqueness

PluginRoleVanilla ImpactPriority
Towny AdvancedLand claiming, towns, optional nations, warsLowHIGH
ShopGUI+Basic market — sell prices ≤ 40% of buy (promotes player trade)LowMEDIUM
Quests + CitizensOptional seasonal storyline with physical NPCsLowMEDIUM
MythicMobsSeason boss — 1–2 events per season, manual spawn onlyLowMEDIUM
Multiverse-CoreResource world management + weekly resetZeroMEDIUM

#Mandatory Configuration Constraints

##EssentialsX — DISABLED features

FeatureStatusReason
Economy (pay, bal, eco)DISABLEDVault + ShopGUI+ handles economy
Kit systemDISABLEDPlayers must earn their gear
Mail systemDISABLEDDiscord handles messaging
Warp managementDISABLEDMultiverse-Core handles warps
AFK kickENABLED10 min timeout — frees slots
/home limitENABLEDMax 3 homes

##AureliumSkills — DISABLED features

FeatureStatusReason
Active abilitiesDISABLEDChanges vanilla combat — violates P-01
Alchemy skillDISABLEDReplaces vanilla brewing
Enchanting skillDISABLEDReplaces vanilla enchanting table
Leaderboard boss barDISABLEDIntrusive constant comparison
Passive skill bonusesENABLEDMining speed, crop yield — additive only
Level-up notificationENABLEDBoss bar, 3 second duration

#Skills Active (AureliumSkills)

SkillPassive BonusMax Level
Mining+drop rate, +speed100
Farming+crop yield, auto-replant100
Foraging+wood drop rate100
Fishing+rare drops, +treasure100
Excavation+gravel/sand drops100
Fighting+damage per level100
Archery+damage, arrow retrieval100
Defense+armor effectiveness100

#Download Sources

PluginOfficial URLPaid?
PaperMCpapermc.io/downloadsFree
Vaultdev.bukkit.org/projects/vaultFree
LuckPermsluckperms.netFree
CoreProtectmodrinth.com/plugin/coreprotectFree
EssentialsXessentialsx.netFree
Towny Advancedgithub.com/TownyAdvanced/Towny/releasesFree
AureliumSkillsaurelium.devFree
Questsmodrinth.com/plugin/questsFree
Citizenscitizensnpcs.coFree
MythicMobsmythicmobs.netFree (Premium ~$10)
ShopGUI+SpigotMC resource page~$20 USD
DiscordSRVmodrinth.com/plugin/discordsrvFree
Dynmapmodrinth.com/plugin/dynmapFree
Multiverse-Coregithub.com/Multiverse/Multiverse-CoreFree

#Related Documents

  • Economy → 03_economy_design.md
  • Towny → 04_towny_nations.md
  • Skills → 05_skills_progression.md
  • Quests → 06_quests_storyline.md
  • Boss → 07_boss_events.md
~ End of Document ~
Kiwi