File Details
VaydFaction 1.2
- R
- Jan 15, 2026
- 405.37 KB
- 212
- Early Access
File Name
VaydFaction-1.2.0.jar
Supported Versions
- Early Access
# VaydFaction Changelog
All notable changes to the VaydFaction mod will be documented in this file.
## [1.0.0] - 2024
### Added
#### Core Faction System
- **Faction Creation & Management**
- `/f create <name>` - Create a new faction
- `/f disband` - Disband your faction (Leader only)
- `/f rename <newName>` - Rename your faction (Leader only)
- `/f description <text>` - Set faction description (Leader only)
- `/f info [faction]` - View faction information
- `/f list` - List all factions on the server
- **Member Management**
- `/f invite <player>` - Invite a player to your faction
- `/f join <faction>` - Join a faction (if invited)
- `/f leave` - Leave your current faction
- `/f kick <player>` - Kick a member from your faction
- `/f promote <player>` - Promote a member to a higher rank
- `/f demote <player>` - Demote a member to a lower rank
- `/f leader <player>` - Transfer leadership to another member
- **Role System**
- **Général (Leader)** - Full permissions, can do everything
- **Officier (Officer)** - Can manage members, claims, and most operations
- **Membre (Member)** - Can claim/unclaim and view information
- **Recrue (Recruit)** - Limited permissions, can only view info and list
#### Territory & Claims
- **Land Claiming**
- `/f claim` - Claim the chunk you're standing in
- `/f unclaim` - Unclaim a chunk from your faction
- `/f map [radius]` - View nearby claims (default: 5 chunks)
- Automatic claim protection (blocks, chests, PvP configurable)
- Claim entry notifications when entering/exiting claimed territory
- Different notification colors based on relationship (own faction, ally, enemy, neutral)
#### Faction Homes
- `/f sethome` - Set faction home at your current location
- `/f home` - Teleport to faction home
- `/f delhome` - Delete faction home
- Cooldown system for home teleportation (configurable)
#### Diplomacy
- `/f ally <faction>` - Form an alliance with another faction
- `/f enemy <faction>` - Declare another faction as enemy
- Alliance permissions (configurable build/break access)
#### Chat System
- **Custom Chat Format**
- Format: `[Role] [Faction] Player: message`
- Roles displayed: Général, Officier, Membre, Recrue
- Different format for players without faction: `[NoFaction] Player: message`
- **Faction Chat Mode**
- `/f chat` or `/f c` - Toggle between global and faction chat
- Faction chat messages only visible to faction members
- Format: `[Faction] [Chat] Player: message`
#### War & Raid System
- **War System**
- `/f war <faction>` - Declare permanent war on another faction
- `/f raid <faction>` - Start a temporary raid (30 minutes, configurable)
- Automatic PvP enabled between warring factions
- War statistics tracking (kills, deaths, wins, losses)
- Notifications for war start/end and raid start/end
#### Power System
- `/f power` - View faction power statistics
- Power calculation based on:
- Base power
- Kills and deaths in wars
- War victories and defeats
- Claims owned
- Power score displayed in faction info
#### Faction Bank
- `/f bank balance` - View faction bank balance
- `/f bank deposit <amount>` - Deposit funds into faction bank
- `/f bank withdraw <amount>` - Withdraw funds from faction bank (permission-based)
- Default balance: 0 (configurable)
- Withdraw permission: Officer+ (configurable)
#### Faction Banner
- `/f banner place` - Place a faction banner at your location
- `/f banner remove` - Remove your faction's banner
- Maximum banners per faction: 1 (configurable)
- Banner location stored for future features
#### Ranking System
- `/f top` - View top 10 factions by power (default)
- `/f top [power|members|claims|wins]` - View rankings by different criteria
- Sortable by:
- Power (default)
- Member count
- Claim count
- War wins
#### GUI Menu System
- `/f menu` - Open the main faction menu
- `/f a <number>` - Select a menu action by number
- `/f close` - Close the current menu
- **Available Menus:**
- Main Menu - Access to all faction features
- Create Faction Menu - Guided faction creation
- Faction Info Menu - Detailed faction information
- Member Management Menu - Invite, kick, promote, demote
- Claim Management Menu - View claim statistics
- War & Raid Menu - Manage wars and raids
- Bank Menu - Manage faction bank
#### Notifications
- **Claim Entry Notifications**
- Notify when entering your own faction's claim
- Notify when entering ally's claim
- Notify when entering enemy's claim
- Notify when entering neutral faction's claim
- Enemy entry notifications to claim owners (configurable)
- **War Notifications**
- War declaration notifications
- Raid start/end notifications
- Configurable notification system
#### Admin Commands
- `/f admin bypass` - Toggle admin bypass mode (OP only)
- `/f admin forcejoin <player> <faction>` - Force a player to join a faction
- `/f admin unclaimall <faction>` - Remove all claims from a faction
- `/f admin disband <faction>` - Force disband a faction
### Configuration
#### Config File (`Server/Config/config.json`)
- **Chat Format Settings**
- Enable/disable chat formatting
- Custom format strings with placeholders
- Faction chat format configuration
- **Faction Settings**
- Max/min name length
- Max description length
- Max claims per faction
- Max members per faction
- Default power
- Power per claim
- Power per kill/death/win/loss
- **Claim Settings**
- Enable/disable claims
- Block protection
- Chest protection
- PvP protection
- Ally build/break permissions
- Enter notification toggle
- **War Settings**
- Raid duration (minutes)
- Auto PvP in war
- Power per kill/death
- **Bank Settings**
- Default balance
- Withdraw permission role
- **Banner Settings**
- Max banners per faction
- **Ranking Settings**
- Default sort by
- Top list limit
- **Notification Settings**
- Enemy enter claim notification
- War start/end notifications
- Raid start/end notifications
- **Reinforced Protection (OP only)**
- Protect explosions
- Protect entities
- Protect spawn zones
- **Permission System**
- Role-based permissions for all commands
- Configurable per role (Leader, Officer, Member, Recruit)
#### Language File (`Server/Config/language.json`)
- All in-game messages configurable
- Support for phrase replacements
- Easy translation support
### Technical Features
- **Data Persistence**
- JSON-based data storage
- Automatic save on important operations
- Data loaded on server start
- **Modular Architecture**
- Separate managers for different systems
- Clean code structure
- Easy to extend
- **Performance**
- Efficient chunk checking system
- Scheduled tasks for periodic checks
- Thread-safe data structures
### Fixed
- Fixed claim entry notifications not showing when returning to your own claim
- Fixed chat format not displaying role names
- Fixed command parsing for commands with sub-arguments (`/f banner`, `/f bank`, etc.)
- Fixed menu commands (`/fa`, `/fc`) by integrating them as `/f a` and `/f close`
- Fixed leader role display in chat (now shows "Général" instead of just faction name)
- Fixed chunk position tracking to properly detect claim re-entry
### Changed
- Renamed mod from "HyFaction" to "VaydFaction"
- Improved chat format to include role names
- Menu system now uses `/f a` and `/f close` instead of separate commands
- Enhanced claim entry detection system
### Known Issues
- Some Hytale API events may not be fully integrated (explosions, entity damage) - requires Hytale API updates
- GUI system uses text-based menus instead of native Hytale GUI (API limitation)
---
## Installation
1. Place `VaydFaction-1.0.0-FAT.jar` in `%AppData%/Hytale/UserData/Mods/`
2. Start your Hytale server
3. Configuration files will be auto-generated in `Server/Config/`
4. Customize `config.json` and `language.json` as needed
## Support
For issues or questions, check the server logs for error messages. Most configuration can be adjusted in `config.json`.
---
**Version:** 1.0.0
**Author:** Vaydor
**Compatibility:** Hytale Server (all versions)
**License:** Free to use and modify