Simple Server Utilities 1.9.0-dev3.24.2

A large development update bringing new progression systems, major World Edit improvements, Entity Insight, minimap customization, NPC improvements, many GUI/UX refinements and a large number of fixes.

---

🏆 Achievements

Added a complete custom Achievement System.

• Create and manage custom achievements entirely in-game
• Rich-text titles and descriptions
• Custom item icons
• Hidden / secret achievements
• Categories and sorting
• Multiple objectives per achievement
• Multiple reward types
• Player progress tracking
• Achievement comparison between players
• Clickable completion announcements
• Admin progress reset tools

Supported rewards include:

• Items
• Money
• Permissions
• Temporary permissions
• Player titles
• Claim capacity
• Cosmetics hooks
• Rewardless achievements for pure bragging rights

The Achievement editor now uses guided controls, selectors and inventory-style item pickers instead of requiring technical IDs wherever possible.

---

📊 Expanded Content & Statistics Framework

A new generic gameplay event/objective framework now powers Achievements and can be reused by other SSU systems.

Objectives can react to many types of gameplay activity, including:

• Breaking blocks
• Killing entities
• Crafting and consuming items
• Damage and healing
• Travelling
• Visiting dimensions and biomes
• Claims
• Auction House activity
• Quests
• Minigames
• Dungeons
• NPC interactions

Custom Statistics also received improvements to persistence, event handling and leaderboard support.

---

❤️ Entity Insight

Added Entity Insight, an optional overhead information system for nearby mobs.

Displays:

• Entity name
• Current / maximum health
• Current attitude

Possible attitudes:

• 🟢 Friendly
• 🟡 Neutral
• 🔴 Hostile
• 🔵 Fleeing

Fleeing state is dynamically detected after recent player interaction.

Armor Stands are excluded from Entity Insight.

---

🛠️ World Edit Improvements

World Edit has been significantly expanded and polished.

Available tools now include:

• Copy
• Cut
• Paste
• Clear
• Fill
• Replace
• Undo
• Redo
• Move
• Rotate
• Mirror
• Vertical Flip
• Save snapshot
• Load snapshot

New World Edit controls

• Left-click block: Set Point 1
• Right-click block: Set Point 2
• Right-click air: Open World Edit GUI

A dedicated compact World Edit overlay/keybind is also available for quick editing while remaining in the world.

Snapshot improvements

Full snapshots can preserve:

• Block states
• Block entities
• Container inventories
• Structural entities such as paintings, item frames and Armor Stands

Ghost previews now use actual Minecraft block models and textures instead of simple placeholder cubes.

Large previews are segmented and culled to reduce unnecessary rendering work.

---

🗺️ Minimap Improvements

The minimap received several visual customization options.

New textured frames

Players can now choose between:

• Classic — original SSU minimap border
• Textured — custom Minecraft-style frame

Both shapes are supported:

• Square
• Circle

The circular minimap uses proper circular clipping, while the square textured minimap is clipped to the inner opening of its frame.

New player marker

The old generated player marker has been replaced by a custom 16×16 Minecraft-style arrow texture.

The marker continues to rotate correctly depending on the selected minimap orientation mode.

---

🧑 NPC Improvements

Several major NPC visual issues have been fixed.

NPC labels

• Removed the duplicate vanilla Minecraft nameplate
• SSU now fully controls NPC name/role labels
• NPC labels are approximately 2× larger
• Labels now scale together with the NPC's configured entity scale
• Label spacing also scales correctly

Custom NPC skins

Custom player-style NPC skins now work correctly.

Supported sources:

• Local server PNG
• Remote HTTPS PNG

Local skins can be placed in:

<world>/simpleserverutilities/npcs/textures/

Remote and local skins must currently be:

• PNG
• 64×64
• Maximum 512 KiB

The custom skin rendering pipeline was fixed so dynamically loaded skins are correctly bound to Minecraft's player renderer instead of displaying the missing-texture pattern.

Remote skin loading also received improved retry handling and diagnostics.

---

🎨 New Dashboard Icons

Added new custom 16×16 Minecraft-style icons for:

• Achievements
• Minigames
• Cosmetics

The player dashboard now also includes a Cosmetics button.

> Cosmetics currently opens a placeholder page and will be expanded in a later development build.

---

🖼️ Hologram Editor Improvements

The Floating Hologram editor received several layout improvements.

• Fixed overlapping text around the color palette
• X / Y / Z coordinate fields are now much more compact
• Each coordinate has its own clear label
• Rich-text formatting controls have been reorganized
• Source and Scoreboard Objective controls have been moved for better readability

---

✉️ Mail GUI Improvements

The Mail Composer has been made significantly more compact.

• Reduced unnecessary vertical space
• Inventory moved upward
• Hotbar moved closer to the inventory
• Back and Send Mail buttons moved upward
• Overall window height reduced

---

🖥️ Server Operations Improvements

Several Server Operations pages received usability improvements.

Server Health

Server Health now shows an easy-to-understand overall status:

• 🟢 GREAT
• 🟢 GOOD
• 🟡 NEUTRAL
• 🟠 BAD
• 🔴 VERY BAD

Technical information such as TPS, MSPT, memory usage and module timings remains available in the detailed view.

Backups

Backup settings now clearly label:

• Backup name
• Automatic backups
• Backup interval
• Number of backups to retain

World Management / Pregeneration

Added clear labels for:

• World Border Center X
• World Border Center Z
• Border Size
• Pregeneration Radius
• Chunks per tick
• Automatic pause MSPT threshold

Activity, Scheduler & Chat

Previously unlabeled numeric and text fields now include proper labels and units throughout these pages.

---

🎮 Minigame Polish

Additional improvements were made to the existing Minigame framework.

Includes continued polish for:

• Capture the Flag
• Domination
• King of the Hill
• Spleef
• Block Party

Block Party and KOTH administration received additional GUI and gameplay fixes.

The Minigames dashboard now uses the new custom games icon.

---

🔐 Reliability & Persistence

Several systems received additional crash-safety and persistence improvements.

Added or improved:

• Content reward ledger
• Reward idempotency
• Temporary permissions
• Achievement persistence
• Statistics persistence
• Auction House event/recovery integration

This helps prevent rewards or progression events from being processed multiple times after a restart or crash.

---

🐛 Important Fixes

• Fixed Achievement item/icon selection not being saved
• Fixed Achievement reward item selection
• Fixed Region Tool right-click opening the GUI while setting Point 2
• Fixed rectangular textured minimap rendering outside its frame
• Fixed NPC vanilla nameplate appearing together with the SSU label
• Fixed local custom NPC skins
• Fixed remote HTTPS custom NPC skins
• Fixed dynamic NPC skin texture binding
• Improved NPC skin error reporting and retry handling
• Multiple GUI overlap, spacing and labeling fixes

---

⚙️ Compatibility

• Minecraft: 26.2
• NeoForge: 26.2.0.7-beta
• Java: 25
• Network protocol: 105

Client and server should always use the same SSU build.

---

🧪 Development Note

SSU is still under active development.

Most systems listed above are functional, but some areas — especially NPCs, Dungeons, Cosmetics and future content integrations — are still being expanded and polished.

Bug reports and feedback are very welcome.