Skip to content

[Feat] Option to disable faction tags on in-game world map #6

@derrickmehaffy

Description

@derrickmehaffy

Scope

  1. Add server-level configuration option to hide faction tags from the in-game world map
  2. When disabled, claimed chunks should still show faction colors but NOT render the faction tag text
  3. Should be configurable via config.json under the worldMap section
  4. Should NOT affect the GUI territory map (only the in-game minimap/world map)
  5. Default behavior should remain showing tags (backwards compatible)

Implementation Details

  1. Suggested config structure:

    {
      "worldMap": {
        "markersEnabled": true,
        "showFactionTags": true
      }
    }
  2. Files to modify:

    • config/HyperFactionsConfig.java - Add showFactionTags boolean field
    • worldmap/ClaimImageBuilder.java - Check config before rendering tag text (around line 486)
    • src/main/resources/config.json - Add default value
  3. Implementation in ClaimImageBuilder.java:

    // Around line 486, wrap tag rendering in config check
    if (showClaimsOnMap && factionInfo != null && HyperFactionsConfig.get().isShowFactionTags()) {
        String tag = factionInfo.tag();
        // ... existing tag rendering code
    }

Risks and Alternatives

  1. Risk: None significant - purely additive config option
  2. Challenge: Ensuring the config is checked at the right point in the rendering pipeline
  3. Alternative: Could make this a per-player setting, but server-level is simpler and matches the request

References and Media

  1. Current implementation: worldmap/ClaimImageBuilder.java:486-493
  2. Config pattern reference: Existing markersEnabled boolean in same section

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions