Oneria Mod

Oneria Mod is a comprehensive utility mod designed specifically for immersive Roleplay (RP) servers. It provides advanced proximity-based obfuscation, sneak stealth mechanics, automated schedule management, staff moderation tools, advanced chat formatting, and seamless LuckPerms integration to create a professional and controlled RP environment.

Key Features

Roleplay Obfuscation (Proximity Blur System)

Create true immersion by hiding player identities based on distance and stealth:

• Proximity-Based Names: Player names in the TabList and overhead become obfuscated when they are beyond a configurable distance.
• Sneak Stealth Mode: Players who are crouching become significantly harder to detect (2 blocks vs 8 blocks by default).
• Dynamic Distance Calculation: System automatically adjusts detection range based on player crouch state.
• Anti-Metagaming: Prevents players from knowing someone's name without meeting them in-game.
• LuckPerms Prefix Support: Option to hide or show rank prefixes based on distance.
• Whitelist System: Specific players or staff members can bypass the blur system entirely.
• Nickname Support: Full integration with custom nicknames set via /oneria nick.
• Nametag Visibility Control: Hide all player nametags server-side using scoreboard teams.
• Highly Configurable: Adjust obfuscation distance, sneak distance, length, and behavior.

Advanced Chat System

Professional chat formatting with markdown and color support:

• Custom Chat Format: Fully customizable chat message template with variables ($time, $name, $msg).
• LuckPerms Integration: Display prefixes and suffixes from LuckPerms in chat.
• Markdown Support: Real-time formatting with **bold**, *italic*, __underline__, ~~strikethrough~~.
• Color Codes: Full support for both & and § color codes in chat messages.
• Timestamp System: Optional timestamps with customizable Java SimpleDateFormat.
• Global Message Color: Set a default color for all chat messages.
• Colors Command: /colors displays all available colors and formatting codes with visual preview.

Advanced Schedule System

Automated server management with smart opening and closing:

• Automated Opening/Closing: Define specific hours (HH:MM format) when the server is accessible.
• Smart Kick System: Automatically kicks non-staff players when the server closes.
• Countdown Warnings: Customizable warnings at 45, 30, 10, and 1 minute before closing.
• Staff Bypass: Staff members (defined by tags, OP level, or LuckPerms groups) can join even when closed.
• Real-Time Status: Players can check server status with /schedule or /horaires.

Staff & Moderation Tools

Professional moderation tools with stealth and transparency:

• Silent Commands: Execute gamemode changes, teleports, and effects without broadcasting to the whole server.
• Staff Logging: Every staff action is logged to the console and broadcasted to other online staff members.
• Teleport Platforms: Define custom teleportation points (platforms) to move players quickly to specific RP zones.
• Permission System: Multi-layered permission detection (Scoreboard tags, OP levels, LuckPerms groups).
• Nickname Management: Set custom nicknames for players with full color code support.

Welcome & Integration

Enhance player experience from the moment they join:

• Custom Welcome Messages: Display multi-line welcome messages with color codes and variable support.
• Sound Effects: Play specific sounds when a player joins (fully customizable).
• LuckPerms Ready: Deep integration with LuckPerms for permissions, prefixes, suffixes, and group management.
• Schedule Integration: Welcome messages include server status and time remaining.

Data Persistence

Smart data management for reliability:

• Nickname Storage: All nicknames are automatically saved to world/data/oneriamod/nicknames.json.
• Auto-Save: Every nickname change is instantly persisted to disk.
• JSON Format: Human-readable format allows manual editing if needed.
• UUID-Based: Nicknames tied to UUIDs, not usernames, for reliability.
• Lazy Loading: Efficient initialization only when needed.

Commands

Configuration Commands

Staff Commands

Whitelist Commands

Nickname Commands

Public Commands

Convenient Aliases

Configuration

The configuration file is located at serverconfig/oneriamod-server.toml. It's fully documented and organized into logical sections:

Configuration Sections

Obfuscation Settings

• proximityDistance - Distance (in blocks) before names are obfuscated (default: 8).
• enableBlur - Master switch for the obfuscation system.
• obfuscatedNameLength - Number of characters in the obfuscated name (default: 5).
• obfuscatePrefix - Whether to hide rank prefixes when obfuscating.
• opsSeeAll - Operators always see all names clearly.
• debugSelfBlur - Enable self-blur for testing purposes.
• hideNametags - Hide all player nametags above heads (default: false).
• whitelist - List of players who bypass the blur system.
• enableSneakStealth - Enable stealth mode for sneaking players (default: true).
• sneakProximityDistance - Detection distance for sneaking players in blocks (default: 2, range: 1-32).

Chat System

• enableChatFormat - Enable custom chat formatting system.
• playerNameFormat - Player name format in chat (variables: $prefix, $name, $suffix).
• chatMessageFormat - Complete chat message format (variables: $time, $name, $msg).
• chatMessageColor - Global color for chat messages (16 Minecraft colors available).
• enableTimestamp - Show timestamp in chat messages.
• timestampFormat - Timestamp format (Java SimpleDateFormat, default: "HH:mm").
• markdownEnabled - Enable markdown styling (**bold**, *italic*, etc.).
• enableColorsCommand - Enable /colors command.

Permissions System

• staffTags - Scoreboard tags considered as staff (default: ["admin", "modo", "staff", "builder"]).
• opLevelBypass - Minimum OP level to be considered staff (default: 2).
• useLuckPermsGroups - Enable LuckPerms group detection.
• luckPermsStaffGroups - LuckPerms groups considered as staff.

Schedule System

• enableSchedule - Enable automated opening/closing.
• openingTime - Server opening time (format: HH:MM, e.g., "19:00").
• closingTime - Server closing time (format: HH:MM, e.g., "23:59").
• warningTimes - Minutes before closing to send warnings (default: [45, 30, 10, 1]).
• kickNonStaff - Automatically kick non-staff at closing time.

Messages

• serverClosedMessage - Message displayed when kicking non-staff.
• serverOpenedMessage - Message sent to staff when server opens.
• warningMessage - Warning message template ({minutes} replaced automatically).
• closingImminentMessage - Final warning 1 minute before closing.

Welcome Message

• enableWelcome - Display welcome message on login.
• welcomeLines - Multi-line message (supports {player} and {nickname} variables).
• welcomeSound - Sound to play on login (e.g., "minecraft:entity.player.levelup").
• welcomeSoundVolume - Sound volume (0.0 to 1.0).
• welcomeSoundPitch - Sound pitch (0.5 to 2.0).

Teleportation Platforms

• enablePlatforms - Enable platform teleportation system.
• platforms - List of platforms (format: id;DisplayName;dimension;x;y;z).

Silent Commands

• enableSilentCommands - Enable staff silent command system.
• logToStaff - Notify other staff members when commands are used.
• logToConsole - Log silent commands to the server console.
• notifyTarget - Notify the target player (default: false for stealth).

Sneak Stealth System

Overview

The sneak stealth system adds a realistic stealth mechanic where players who are crouching (sneaking) become significantly harder to detect. Their names will only be visible to nearby players within a much smaller radius.

How It Works

• Normal Detection: Players standing normally are visible at the standard proximity distance (default: 8 blocks).
• Sneak Detection: Players who are crouching are only visible at the sneak proximity distance (default: 2 blocks).
• Dynamic Switching: The system automatically detects the player's crouch state and applies the appropriate distance.
• Admin Override: Staff members with opsSeeAll enabled always see all players, regardless of sneak state.

Use Cases

• Stealth Roleplay: Hide from other players by crouching in crowded areas.
• Hide and Seek: Perfect for RP mini-games where players need to hide.
• Ambush Scenarios: Set up surprise encounters without revealing your presence in TabList.
• Privacy: Move through areas without being immediately recognized by distant players.
• Realistic Immersion: Crouching for stealth mirrors real-world behavior and expectations.

Configuration Commands

# Toggle sneak stealth system
/oneria config set enableSneakStealth true/false

# Set sneak detection distance (1-32 blocks)
/oneria config set sneakProximityDistance 2

# Check current settings
/oneria config status

Example Scenarios

Scenario 1: Hiding in a Crowd

• Player A is crouching in a busy marketplace
• Player B is 5 blocks away (beyond sneak distance of 2)
• Player B sees "§k?????" instead of Player A's name
• Player A successfully remains anonymous

Scenario 2: Close Encounter

• Player A is crouching behind a building
• Player B walks within 2 blocks
• Player B can now see Player A's name
• Player A's cover is blown

Scenario 3: Admin Surveillance

• Staff member with opsSeeAll monitoring the server
• Can see all players' names regardless of sneak state or distance
• Perfect for moderation and rule enforcement

Installation

Requirements

• Minecraft: 1.21.1
• NeoForge: 21.1.215 or higher
• Optional: LuckPerms (for advanced permissions, prefix/suffix support, and chat integration)

Steps

1. Download the latest oneriamod-X.X.X.jar from the releases page.
2. Place the JAR file into your server's mods folder.
3. (Optional) Install LuckPerms for advanced permission management and chat prefixes/suffixes.
4. Start your server to generate the configuration file.
5. Edit serverconfig/oneriamod-server.toml to customize your settings.
6. Reload with /oneria config reload or restart the server.

Technical Details

Performance

• Permission Caching: Results cached for 30 seconds to minimize overhead.
• Tick Optimization: Schedule system checks only every 20 seconds (400 ticks).
• Efficient Packet Handling: Minimal performance impact on TabList updates.
• Optimized Color Parsing: Segment-based parsing for complex formatting with minimal overhead.
• Sneak Detection: Native isCrouching() check with zero overhead.

Compatibility

• Server-Side Only: No client-side installation required.
• Mixin-Based: Uses Mixin for clean packet interception and chat formatting.
• API Ready: Public API available for other mods (OneriaPermissions.isStaff(), etc.).
• LuckPerms Integration: Full support for prefixes, suffixes, and group-based permissions.

New in 1.1.3

• Sneak Stealth System: Dynamic distance calculation based on player crouch state.
• Enhanced Obfuscation: Seamless integration of sneak mechanics with existing blur system.
• Configurable Sneak Distance: Adjustable detection range for crouching players (1-32 blocks).
• Admin Exemption: Staff with opsSeeAll always see sneaking players.

License

This mod is developed for the Oneria RP Server and is provided as-is for community use. You are free to use it on your own server, but official support and updates are prioritized for the Oneria server.

All Rights Reserved © 2026 Oneria Team

Credits

• Development: Finerus, OneriaTeam
• Special Thanks: The Oneria RP community for testing and feedback
• Libraries: NeoForge, Mixin, LuckPerms API

Support

For issues, suggestions, or questions:

• Discord: Join the Oneria Discord server
• GitHub Issues: Report bugs on our repository

Note: This mod is actively maintained for the Oneria server. Community contributions and feedback are welcome!