Pull request: secure and distribute Wall Art controllers

• Made Wall Art configuration opening server-authoritative and restricted it to the controller's UUID owner, with localized denial feedback.
• Added the missing Wall Art block display name and a localized /xwallart confirmation.
• Added the permission-free /xwallart player command, including safe item dropping when the inventory is full.

Pull request: fix Wall Art collision and wall orientation

• Made Wall Art non-colliding like vanilla 1.7.10 vines while retaining its thin metadata-oriented selection and ray-trace bounds.
• Derived the controller's supporting-wall facing from the clicked horizontal face, rejected vertical attachment, and stopped player yaw from overwriting placement metadata.
• Added clicked-side support validation, centralized placement/support direction mapping, and replaced invalid metadata's full-cube bounds with a safe thin panel.

Pull request: synchronize Wall Art controller visibility

• Invalidated cached client block geometry when synchronized Wall Art image, facing, or display dimensions change, so configured controllers disappear and cleared controllers reappear immediately.
• Explicitly synchronized newly placed Wall Art tile metadata after server-side ownership and facing initialization.
• Preserved hash-driven controller visibility, thin interaction and inventory geometry, and the existing tile renderer and server update path.

Pull request: fix Wall Art block rendering

• Hid configured Wall Art controller geometry while preserving the downloaded-image TESR and the logical block's interaction bounds.
• Added a dedicated Forge 1.7.10 block renderer for metadata-oriented thin fallback panels in the world.
• Rendered the Wall Art inventory item as a fixed, thin vertical panel using its neutral fallback texture.

Pull request: re-audit Wall Art importing against ImageFrame

• Added an independent Wall Art source policy with correct Postimages page/CDN defaults, bounded source dimensions and bytes, manual redirect limits, and separate success/failure cooldowns.
• Added bounded HTML image-page resolution for secure OpenGraph metadata and a limited image fallback, while revalidating every resolved URL and redirect with the existing SSRF protections.
• Switched Wall Art requests to a browser-compatible user agent, retained byte-level PNG/JPEG verification and memory-efficient source subsampling, and improved actionable HTTP, resolver, timeout, size, and decode errors.
• Refactored the asynchronous import lifecycle and all Wall Art-specific source files for readable Java, accurate in-progress/cooldown messages, short failure retries, sanitized diagnostics, and main-thread-only world updates.

Pull request: fix Wall Art image importing

• Separated bounded Wall Art source downloads and source-dimension safety checks from the much smaller custom faction flag import limits.
• Added metadata-first PNG/JPEG decoding with source subsampling so normal high-resolution photographs are efficiently scaled into the selected 128x128 through 640x640 Wall Art canvas.
• Improved direct HTTPS image handling with byte-based format detection, query-safe parsed-host validation, per-redirect SSRF checks, bounded streamed downloads, image-oriented request headers, and clearer errors for HTML or unsupported payloads.
• Retained server-worker processing, final-image hashing, bounded PNG storage and transfer, and the existing HTTPS host whitelist.

Pull request: fix Wall Art block and configuration GUI

• Centered and restored the Wall Art URL, display-size, and download controls by separating display dimensions from the inherited GUI screen dimensions.
• Preserved URL text and selected dimensions across GUI resizing, and added an inline prompt for empty submissions.
• Replaced the missing fallback texture reference with the existing neutral concrete panel texture while retaining dynamic image rendering.
• Made wall-mounted controllers drop when their supporting wall is removed using Forge 1.7.10 side-solid checks.

Pull request: fix Forge 1.7.10 Wall Art compilation

• Updated Wall Art support checks to use Forge 1.7.10 ForgeDirection values for each neighboring wall face.
• Removed the unreferenced legacy image-placement helper that still wrote deleted URL, name, and string-owner fields directly into Wall Art tile entities.
• Preserved the server-authoritative Wall Art service, metadata-only tile entities, and the wall_image_block registry identity.

Pull request: fix development runClient identities

• Restored GTNH's blank-name Developer<random numbers> behavior for default development clients.
• Assigned one fresh random UUID during each Gradle invocation before the run task finalizes its properties, while retaining validated independent devUsername and devUuid overrides.
• Kept runClient identity logging read-only so task execution no longer attempts to mutate finalized Gradle properties.

Pull request: isolate faction saves and randomize development players

• Reset all faction, membership, diplomacy, claim, cooldown, protection, and overlay runtime state at the logical-server overworld lifecycle boundary, while retaining one shared database across dimensions.
• Bound cached faction data and auxiliary JSON persistence to the active save so a new or reopened world cannot inherit another world's state.
• Give each runClient execution a validated random development username and UUID by default, while preserving independent devUsername and devUuid overrides.

Pull request: fix JourneyMap minimap claim clipping

• Kept JourneyMap's depth-based minimap mask active while faction claim fills, borders, and labels render, preventing overlay geometry from escaping circular and rectangular minimap interiors without adding a separate clipping system.
• Preserved fullscreen claim rendering and the corrected legacy territory-coordinate bounds by limiting the change to Xenofactions-owned OpenGL state.

Pull request: fix JourneyMap faction claim alignment

• Corrected JourneyMap claim polygons, exposed borders, and territory-label bounds to use the exact inverse of Xenofactions' legacy +1 and truncating integer coordinate conversion instead of treating stored territory coordinates as vanilla chunks.
• Covered positive, negative, axis-crossing, and near-origin territory bounds with focused regression tests while preserving real flag-block label positions and the reflection-only JourneyMap integration.

Pull request: show command-specific help in the Xenofactions GUI

• Replaced generic legacy-execution text in the Xenofactions command GUI with concise descriptions of each command's actual behavior.
• Aligned faction and administrator GUI help with the current grouped /c and /xc commands and clarified utility-command documentation.

Pull request: complete Xenofactions command GUI localization

• Completed localization for the remaining Admin and TDM command GUI entries, including City Center cancel-move and recover-move commands.
• Added source-level validation to require an English name and description for every command catalog entry.

Pull request: fix Earth chunk-check command compilation

• Qualified the Minecraft command integer parser used by /xc earth check, allowing the standalone Earth command handler to compile while retaining standard invalid-coordinate command errors.

Pull request: restore canonical faction roles after UUID identity refactor

• Fixed global chat and the XF menu to resolve live players through their canonical FactionMemberRecord, so UUID-mode owners and officers no longer appear as citizens.
• Centralized role display, owner name, member count, and member-list data on canonical records rather than deprecated username collections.
• Corrected promote, demote, ownership-target, kick, leave, merge, disband, and online membership paths so permissions and membership changes take effect immediately and persist from UUID records.
• Preserved NAME and AUTO identity behavior by resolving both modes to the same member record before checking its FactionRole; username-only permission lookup remains fail-closed outside NAME mode.
• Retained legacy leader/member/officer fields strictly as old-save migration and compatibility mirrors.

PR: Command namespace cleanup

• Grouped recent player faction commands under /c and administrator/Earth commands under /xc, removing their standalone roots.

Xenofactions v2.1.7 Hotfix

Multi-Dimension Compatibility

• Fixed numerous systems that still assumed the Overworld when resolving territory ownership.
• Prestige buildings, structures, tents, statues, flags, and other tile entities now correctly resolve ownership in the dimension they are placed in.
• Improved dimension-aware claim lookups throughout the mod to ensure territory ownership behaves correctly in custom dimensions.
• Added additional legacy save migration for older worlds that did not store dimension information. Legacy homes and warps are automatically migrated to the Overworld (dimension 0) during loading.
• Removed vanilla sky visibility requirements from foundation-based structures, allowing them to function correctly in dimensions with permanent ceilings (such as the Nether, End, and similar modded dimensions). Structures now validate their foundation and available build space instead.

Persistence Improvements

• Fixed faction alliances not persisting across server restarts.
• Fixed runtime administrator war settings resetting after server restarts.
• Improved save/load handling for faction diplomacy and runtime state to ensure data is consistently restored.
• Added automatic restoration of alliance references after world data loads.
• Improved persistence verification for alliances, war state, and dimension-aware data.

City Center & Faction Information

• City Center GUIs now immediately update whenever prestige generation changes instead of waiting for the hourly prestige tick.
• Added a live prestige generation display showing current hourly prestige income.
• /c info now displays current prestige generation per hour and net prestige generation directly from live faction data.
• /c info now refreshes City Center information from loaded tile entities, ensuring upgraded city levels, radius, upkeep, and dimension information are always accurate.

Alliance Improvements

• Added /c allies and /c allylist as quick aliases for viewing alliances.
• Improved alliance listings to display None when a faction has no allies.
• Alliance listings now also display any pending alliance offers.
• /c info now displays allied factions alongside enemies for a complete diplomatic overview.
• Added internal formatting improvements for alliance and pending-offer displays.

Commands & Documentation

• Added the new alliance aliases to command tab completion.

• Updated command documentation for /c alliance, /c allies, and /c allylist.

• Expanded server administration documentation with additional verification steps for:

  • Alliance persistence
  • Runtime war-state persistence
  • City Center prestige synchronization
  • /c info prestige generation reporting
  • City upgrade reporting
  • Multi-dimension structure placement
  • Foundation-based structures in ceiling dimensions

Internal

• Expanded the multi-dimension audit across additional systems and tile entities.
• Improved world-data serialization reliability.
• Added migration logging for legacy save upgrades.
• General stability, compatibility, and quality-of-life improvements.

Xenofactions Update Changelog

🌍 Multi-Dimension Territory Support

Xenofactions now fully supports claiming, protecting, conquering, and managing territory across multiple Minecraft dimensions.

New Features

• Claims are now fully dimension-aware.

• Factions can independently own the same chunk coordinates in different dimensions.

• Nether, End, and custom mod dimensions now support faction claims.

• Territory borders, ownership checks, and protection all correctly use the active world dimension.

• Dynmap now renders claims separately for each configured dimension.

• Added configurable dimension support:

  • enableClaimsInAllDimensions
  • allowedClaimDimensions
  • blockedClaimDimensions
  • dynmapDimensionWorldMap

Teleport & Home Improvements

• Faction Homes now remember their dimension.
• Ally Warps now remember their dimension.
• Faction Warps now remember their dimension.
• Teleports automatically transfer players to the correct dimension before moving them.
• Added safeguards to prevent teleports into unloaded or unavailable dimensions.

Save Compatibility

• Existing worlds migrate automatically.
• Legacy claims without stored dimension data are interpreted as Overworld (Dimension 0).
• Legacy faction homes and warps automatically default to Dimension 0.
• Existing claims and faction data are preserved without requiring manual conversion.

---

⚔ War System Improvements

War Confirmation

Declaring war now requires confirmation to prevent accidental prestige loss.

• /c war <faction> (or /c declarewar) now prompts for confirmation.
• Re-run the command within 10 seconds to finalize the declaration.
• War conditions are revalidated before prestige is spent.

Duplicate War Prevention

• Fixed an issue allowing the same two factions to declare war multiple times.
• Duplicate active wars are now prevented regardless of which faction initiated the declaration.

Better War Information

Faction information now includes an Enemies section displaying every faction currently at war with yours.

Added:

• /c listwars

Displays every active war involving your faction, including:

• Enemy faction
• Which faction declared the war
• War duration
• Current raid/conquest availability

---

🏴 Cross-Dimension Warfare

War conquest mechanics now function correctly across every supported dimension.

• Territory capture correctly resolves ownership using the world's actual dimension.
• Border checks are dimension-aware.
• Conquest flags now capture land in Nether, End, and custom dimensions correctly.
• Fixed cross-dimension coordinate collisions during conquest.

---

🛠 Internal Improvements

• Territory storage has been rewritten to use dimension-aware claim identifiers.
• Claim serialization, loading, migration, and persistence now include dimension information.
• Improved saved-data handling so all dimensions safely access the shared faction database.
• Updated city spacing and territory validation to only compare cities within the same dimension.
• Improved server-side migration logging for legacy worlds.

---

🐞 Bug Fixes

• Fixed world tick crashes caused by non-overworld saved data access.
• Fixed conquest failing outside the Overworld.
• Fixed /c create initialization issues involving null world references.

This update lays the foundation for fully multi-dimensional faction gameplay, allowing servers to build persistent empires across the Overworld, Nether, End, and custom dimensions without territory conflicts.

Hotfix for Xenofactions Customflags Should fix memory leaks/extreme memory usage

Xenofactions

• Added an optional in-game Xenofactions Handbook using Guide-API.

• Added guides covering factions, cities, claims, prestige, diplomacy, wars, and protection systems.

• Added admin and troubleshooting documentation.

• Added localization support for handbook content.

• Added config option to enable or disable handbook registration.

• Added safe fallback behavior when Guide-API is not installed.

Added new hooks for the distant explosion sound for use in Mcheli-Overdrive.

Xenofactions 2.1 Stable Release

The largest Xenofactions update to date, featuring a complete overhaul of warfare, diplomacy, territory management, prestige, administration, and server customization.

---

Warfare & Diplomacy Overhaul

New War System

• Wars are now faction-versus-faction.
• War declarations require target factions to meet online activity requirements.
• Allied factions can participate in allied wars.
• Allies can no longer declare war on each other.
• Alliance breaks now trigger war cooldowns.
• Added configurable war declaration requirements and restrictions.

Diplomacy

• Added Surrender, Ceasefire, and Peace agreements.
• Added configurable war cooldown periods.
• Added city transfer peace terms.
• Cities can now be ceded during surrender and peace negotiations.

Raid System Rework

• Added online-based raid protection.
• Added war-age requirements before raids can begin.
• Added extensive administrative controls for war and raid restrictions.
• Legacy behavior can be restored through configuration.

---

Prestige & Nation Economy Overhaul

New Prestige Economy

• Completely rebalanced prestige generation and upkeep.
• Added land upkeep costs.
• Rebalanced city, building, and territorial expansion costs.
• Added scaling city settlement costs.
• Added prestige-based war declaration costs.
• Medical Tents now consume prestige.
• Warp Tents now have significantly increased upkeep.

National Stability System

• Wars now consume prestige over time.

• Long wars become progressively more expensive.

• Added Prestige Bankruptcy stages:

  • Financial Crisis
  • National Collapse
  • Fallen Nation

• Added escalating penalties for nations that fail to maintain prestige.

War Reparations

• Surrendering factions now transfer 50% of their prestige generation to the victor for 84 hours.

---

City & Territory Overhaul

City Centers

• Replaced traditional Claim Flags with City Centers.
• Cities must now be founded and named.
• Territory expansion is now tied to city claim radius.
• Added city ownership tracking.
• Added city placement validation and territory restrictions.
• Added non-overlapping city borders.
• Added minimum spacing requirements between cities.

City Progression

• Added five city development levels:

  • Settlement
  • Town
  • City
  • Metropolis
  • Capital

• Added city upgrade system.

• Added claim radius scaling based on city level.

• Maximum city radius is now 6 chunks.

City Management

• Added city rename popup during founding.
• Added city ownership transfers.
• Added duplicate city name protection.
• Added city upgrade confirmations and cost previews.
• Added prestige cost previews for city creation.
• Improved city conquest behavior and territory transfers.

---

Dynmap Integration

Optional Dynmap Support

• Added automatic Dynmap detection with no hard dependency.
• Added live faction territory overlays.
• Added city border rendering.
• Added city center markers.
• Added faction-colored territory visualization.

Dynmap Information Tooltips

• City Name
• Owning Faction
• City Level
• Claim Count
• Chunk Coordinates

Live Updates

Dynmap overlays automatically update when:

• Cities are created
• Cities are renamed
• Cities are transferred
• Cities are removed
• Territory changes occur
• Faction names change
• Faction colors change

---

Custom Faction Flags

Custom Flag Images

• Added support for custom faction flags using image URLs.
• Imported flags are automatically downloaded, validated, resized, sanitized, and cached.
• Added client-side texture synchronization and caching.
• Added fallback handling for missing or invalid images.
• Custom flags now display throughout Xenofactions interfaces.

Security

• Restricted imports to approved image hosts.
• Added image size, dimension, and format validation.
• Added metadata stripping and image sanitization.
• Added protection against invalid URLs and unsafe redirects.
• Downloads are processed asynchronously to avoid server lag.

---

Team Deathmatch Expansion

New TDM Features

• Map definitions
• Map voting
• Per-map kit definitions
• Dedicated TDM menu
• Friendly-fire protection

TDM Command Overhaul

• Consolidated TDM under the /tdm command tree.
• Added /tdm menu and /tdm openmenu.
• Reorganized help pages and command structure.
• Improved validation and usage feedback.
• Unified team switching behavior.
• Removed legacy TDM commands.

---

Protection Systems

New Player Protection

• Added configurable new-player protection.
• 4-hour PvP grace period.
• 24-hour keep-inventory protection.
• Persistent UUID-based storage.
• Protection survives restarts and offline periods.

Build Grace

• Added one-time 48-hour build grace.
• Protected factions cannot attack or be attacked.
• Protected factions cannot enter wilderness or foreign territory.
• Added administrative controls for resetting or ending grace periods.
• Reworked border handling and movement enforcement.

---

Configuration Overhaul

New Configuration System

• Added extensive configuration options covering:

  • Warfare
  • Raiding
  • Diplomacy
  • Cities
  • Prestige
  • Protection Systems
  • Gameplay Balancing

Configuration Improvements

• Reorganized hfr.cfg into structured categories.
• Added documentation and comments throughout the configuration.
• Improved readability and maintainability.
• Added automatic migration support for legacy entries.
• Removed deprecated and duplicate config generation.

Additional Configuration

• Added configurable minimum and maximum Y-level options for stone drops.

---

Commands & Quality of Life

• Reworked /c and /xc command handling.
• Improved command validation and error reporting.
• Added player, faction, and command tab completion.
• Improved support for faction names containing spaces.
• Expanded and reorganized help menus.
• Added numerous city, territory, conquest, and ownership validation checks.

---

Stability & Bug Fixes

• Fixed territory transfer issues during faction merges.
• Fixed conquered cities not transferring territory correctly.
• Fixed claims persisting after City Center removal.
• Fixed invalid City Centers causing errors.
• Fixed city rename behavior.
• Fixed MCHeli-related crashes when the mod is absent.
• Improved movement handling around protected borders.
• Reduced chat spam and false-positive border enforcement.
• Numerous warfare, diplomacy, city, GUI, and territory management fixes.

Xenofactions 2.1 marks the completion of the major warfare, diplomacy, city, and prestige systems and serves as the project's long-term stable release. We hope you all enjoy it!