SimpleGroupsAndClaims


SimpleGroupsAndClaims is a lightweight yet powerful group and land-claiming plugin designed for Minecraft servers running Spigot or Paper. It provides a simple way for players to form groups, claim land, manage alliances, and engage in controlled PvP with a built in, configurable combat logging system. Perfect for SMP and faction-like gameplay without the complexity and confusing GUI's, this plugin emphasizes simplicity, performance, and customization.

Features
Group Management

• Create and Manage Groups: Players can create groups, invite members, and assign moderators to help manage the group.
  
  
• Leadership Roles: Each group has a leader who can rename the group, set group name color, transfer leadership, or delete the group.
  
  
• Moderator Role: Leaders can promote members to moderators, granting them permissions to invite players and manage claims.
  
  
• Inactivity System: Automatically removes inactive members, moderators, and entire groups based on configurable inactivity times to keep your server clean.

Land Claiming

• Chunk-Based Claims: Groups can claim chunks to protect their territory, with claim limits based on group age and configurable growth rates.
  
  
• Claim Visualization: A dynamic 9x9 chunk scoreboard map shows claimed, allied, safe, neutral, and wilderness areas, updating based on player movement and rotation.
  
  
• Protection: Prevents block breaking, placement and container access on player owned claims, and environmental changes (e.g., explosions, piston movement) in safe and neutral zones.
  
  
• Safe and Neutral Zones: Admins can designate safe zones (No claiming, greifing or PvP unless in combat) and neutral zones (no claiming or greifing).

Alliances

• Alliance System: Groups can form alliances to prevent friendly fire.
  
  
• Request and Approval Process: Leaders can send and accept alliance requests, both sides must accept.

PvP Combat Timer

• Combat Tagging: Engages a configurable combat timer when players attack each other, preventing combat logging by killing players who disconnect during combat.
  
  
• Boss Bar Feedback: Displays a configurable timer to players in combat. Players die if logging out whilst in combat.

• Safe Zone Restrictions: PvP is disabled in safe zones unless players are already in combat.

Chat and Visual Enhancements

• Group Chat Prefixes: Displays group names and roles ([L] for Leader, [M] for Moderator, [G] for Member) in chat.
  
  
• Action Bar Notifications: Informs players when they enter different zones (e.g., group land, wilderness, safe zones).
  
  
• Scoreboard Map: Toggles a real-time map showing nearby chunks with color-coded ownership (green for own group, purple for allies, yellow for other groups, blue for safe zones, gold for neutral zones).

Configuration and Administration

• Highly Configurable: Adjust claim limits, combat timer duration, group name rules, and inactivity periods via config.yml.
  
  
• Admin Commands: Tools for setting safe and neutral zones, reloading configurations, and managing server-wide settings.
  
  
• Persistent Data: Group and claim data are saved in groups.yml for retention during server restarts.

Commands & Descriptions

/g create <name>
Creates a new group with the specified name.

/g rename <newname>
Renames the group (leader only).

/g setcolor <COLOR>
Sets your group name color in chat (leader only).

/g invite <player>
Invites a player to the group (leader or moderator only).

/g uninvite <player>
Revokes group invite to the group (leader or moderator only).

/g accept <group>
Accepts a pending group invitation.

/g kick <player>
Kicks a member or moderator from the group (leader only).

/g promote <player>
Promotes a member to moderator (leader only).

/g demote <player>
Demotes a moderator to member (leader only).

/g transfer <player>
Transfers group leadership to another member or moderator (leader only).

/g leave
Leaves the current group.

/g delete
Deletes the group (leader only).

/g allyrequest <group>
Sends an alliance request to another group (leader only).

/g acceptally <group>
Accepts a pending alliance request (leader only).

/g denyally <group>
Denies a pending alliance request (leader only).

/g unally <group>
Ends an alliance with another group (leader only).

/g claim
Claims the current chunk for the group (leader or moderator only).

/g unclaim
Unclaims the current chunk (leader or moderator only).

/g map
Toggles the chunk scoreboard map.

/g info
Displays group information (members, moderators, leader, claims, allies, creation date, next claim growth date).

Admin (OP) Commands & Descriptions

/g setsafezone
Sets the current chunk as a safe zone.

/g removesafezone
Removes the current chunk as a safe zone.

/g setneutralzone
Sets the current chunk as a neutral zone.

/g removeneutralzone
Removes the current chunk as a neutral zone.

/g reload
Reloads the plugin configuration.


Permissions

• SimpleGroupsAndClaims.admin: Grants access to admin commands (setsafezone, removesafezone, setneutralzone, removeneutralzone, reload). Typically assigned to server operators.
  
  
• Default Permissions: All players can use non-admin commands without additional permissions.

Configuration
The plugin uses two configuration files: config.yml and groups.yml.

config.yml
group:
starting-claims: 10 # Initial claim limit for new groups
claim-growth-per-week: 2 # Additional claims per week of group age
name:
min-length: 3 # Minimum group name length
max-length: 20 # Maximum group name length
blacklist: [] # List of banned group names
inactivity-days: 30 # Days before inactive members/moderators are kicked or groups are deleted

pvp:
timer-duration-seconds: 15 # Duration of PvP combat timer

groups.yml
Stores group data, claims, pending invites, alliances, and zone information. Automatically managed by the plugin; manual editing is not recommended.

Installation

1. Download the SimpleGroupsAndClaims.jar file.
   
   
2. Place it in your server's plugins folder.
   
   
3. Restart your server.
   
   
4. Edit config.yml to your preferences.
   
   
5. Restart server or type /g reload to apply changes without restarting.

Compatibility

• Minecraft Versions: Tested on 1.21+ (Spigot/Paper).
  
  
• Dependencies: None; standalone plugin.

Support

• Issues: Report bugs or request features on the SpigotMC Discussion Thread.
  
  
• Suggestions: Feedback to improve the plugin on the SpigotMC Discussion Thread is greatly appreciated.
  
  
• Documentation: Full command and configuration details are available in-game via /g and in this description.

Planned Features

• Locking system for containers and interactable blocks (doors, trapdoors etc).

• API for developers to extend functionality.