Commands & Permissions

This guide covers all available commands, their usage, permissions, and examples for NHideAndSeek plugin.

Command Overview

All NHideAndSeek commands use the base command /has or /hideandseek.

Player Commands

Join games, view stats, purchase effects, and more

Admin Commands

Create arenas, manage games, configure settings

Player Commands

Commands available to all players without special permissions.

Basic Commands

/has help

Description: Display command help menuUsage: /has helpPermission: None (default)Example:

/has help

Shows a list of available commands based on your permissions.

/has menu

Description: Open the arena selection menuUsage: /has menuPermission: None (default)Aliases: NoneExample:

/has menu

Opens a GUI showing all available arenas with their current status and player counts.

/has join <arena>

Description: Join a specific arenaUsage: /has join <arena>Permission: None (default)Arguments:

<arena> - Name of the arena to join

Examples:

/has join lobby
/has join parkour
/has join citymap

Notes:

Arena must be in waiting/countdown state
Arena must not be full
You cannot join if already in a game

/has leave

Description: Leave your current gameUsage: /has leavePermission: None (default)Example:

/has leave

Notes:

Returns you to main lobby (if configured)
Your statistics are saved
You can rejoin immediately

/has list

Description: List all available arenasUsage: /has listPermission: None (default)Example:

/has list

Shows arena names, current player counts, and game status.

Statistics Commands

/has stats [player]

Description: View player statisticsUsage: /has stats [player]Permission: None (default)Arguments:

[player] - Optional player name (defaults to yourself)

Examples:

/has stats
/has stats Notch
/has stats Steve123

Statistics Displayed:

Games played & won
Wins as Hider/Seeker
Total kills & deaths
K/D ratio
Win rate percentage
Total coins
Time played

/has leaderboard

Description: View top players leaderboardUsage: /has leaderboardPermission: None (default)Aliases: /has topExamples:

/has leaderboard
/has top

Leaderboards:

Top Wins
Top Kills
Top Coins
Top Games Played

Shows top 10 players in each category.

Shop & Effects

/has effects

Description: Open the effects shopUsage: /has effectsPermission: None (default)Aliases: /has shopExamples:

/has effects
/has shop

Features:

Browse WIN, KILL, and DIE effects
Purchase effects with coins
Select active effects
Preview effect descriptions

Communication

/has chat

Description: Toggle between chat modesUsage: /has chatPermission: None (default)Example:

/has chat

Chat Modes:

Global Chat - Talk to all players on the server
Team Chat - Talk only to players in your arena
Spectator Chat - Spectators and admins only

Cycles through available modes based on your game state.

Admin Commands

Commands for server administrators and moderators.

Arena Management

/has create <arena>

Description: Create a new arenaUsage: /has create <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the new arena (alphanumeric)

Examples:

/has create lobby
/has create forest
/has create citymap

Notes:

Arena name must be unique
Creates arena with default settings
Requires further setup with editor mode
Arena starts as disabled until setup is complete

/has delete <arena>

Description: Delete an existing arenaUsage: /has delete <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the arena to delete

Examples:

/has delete oldmap
/has delete testarea

Warning:

This action is permanent! The arena configuration file will be deleted.

Kicks all players from the arena
Deletes arena configuration file
Cannot be undone

/has editor <arena>

Description: Enter/exit arena editor modeUsage: /has editor <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the arena to edit

Examples:

/has editor lobby
/has editor parkour

Editor Mode Features:

Set arena boundaries (pos1, pos2)
Configure spawn points
Set world region
Visual tools for setup

Tools Received:

Arena Wand - Left click: pos1, Right click: pos2
Spawn Wand - Right click to set spawn points

Use /has editor again to exit editor mode.

/has setspawn <type>

Description: Set spawn point at your current locationUsage: /has setspawn <type>Permission: nhideandseek.adminArguments:

<type> - Spawn type: lobby, hider, seeker, spectator

Examples:

/has setspawn lobby
/has setspawn hider
/has setspawn seeker
/has setspawn spectator

Spawn Types:

lobby - Where players wait before game starts
hider - Random spawn for hiders (add multiple)
seeker - Where seekers spawn (add multiple)
spectator - Where spectators are teleported

Notes:

Must be in editor mode
Hider/Seeker spawns can be set multiple times
Players spawn at random hider/seeker spawn points

/has settings <arena>

Description: Open arena settings GUIUsage: /has settings <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the arena to configure

Examples:

/has settings lobby
/has settings forest

Configurable Settings:

Min/Max players
Game duration
Hiding time
Seeker ratio
Hider effects (speed, invisibility, scale)
Seeker fireball settings
Team balance options
Priority seeker permissions

Game Control

/has start

Description: Start the game you’re currently inUsage: /has startPermission: nhideandseek.adminExample:

/has start

Requirements:

Must be in a game
Game must be in waiting/countdown state
Minimum player count must be met

/has stop

Description: Stop the game you’re currently inUsage: /has stopPermission: nhideandseek.adminExample:

/has stop

Notes:

Ends the game immediately
No winner declared
Players returned to lobby

/has forcestart <arena>

Description: Force start a game regardless of player countUsage: /has forcestart <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the arena

Examples:

/has forcestart lobby
/has forcestart citymap

Notes:

Bypasses minimum player requirement
Useful for testing
Game may be unbalanced with few players

/has forcestop <arena>

Description: Force stop a game from console or remotelyUsage: /has forcestop <arena>Permission: nhideandseek.adminArguments:

<arena> - Name of the arena

Examples:

/has forcestop lobby
/has forcestop forest

Notes:

Can be used from console
Stops game immediately
Useful for emergency situations

/has setrole <player> <role>

Description: Pre-assign a player’s role in lobbyUsage: /has setrole <player> <hider|seeker|auto>Permission: nhideandseek.adminArguments:

<player> - Player name
<role> - Role: hider, seeker, or auto

Examples:

/has setrole Notch seeker
/has setrole Steve hider
/has setrole Alex auto

Notes:

Only works in lobby phase (before game starts)
Player is notified of role assignment
auto removes manual assignment
Role is locked until game starts
Useful for content creators or special events

Great for YouTube videos where you want specific players to be seekers!

/has settime <arena> <seconds>

Description: Set game duration for an arenaUsage: /has settime <arena> <seconds>Permission: nhideandseek.adminArguments:

<arena> - Arena name
<seconds> - Duration in seconds

Examples:

/has settime lobby 300
/has settime forest 600
/has settime quick 180

Recommended Durations:

3 minutes (180s) - Quick games
5 minutes (300s) - Standard games
10 minutes (600s) - Long games

Player Management

/has coins <player> <action> [amount]

Description: Manage player coinsUsage: /has coins <player> <add|set|remove|check> [amount]Permission: nhideandseek.adminArguments:

<player> - Player name
<action> - Action: add, set, remove, or check
[amount] - Amount of coins (not needed for check)

Examples:

/has coins Notch check
/has coins Steve add 100
/has coins Alex set 500
/has coins Player remove 50

Actions:

check - Display current coin balance
add - Add coins to player’s balance
set - Set exact coin amount
remove - Remove coins from balance

Aliases:

/has setcoins
/has addcoins

/has resetstats <player>

Description: Reset a player’s statisticsUsage: /has resetstats <player>Permission: nhideandseek.adminArguments:

<player> - Player name (online or offline)

Examples:

/has resetstats Notch
/has resetstats Steve123

What Gets Reset:

Games played & won
Wins as Hider/Seeker
Total kills & deaths
K/D ratio
Win rate
Coins (set to 0)
Time played

This action is permanent and cannot be undone!

Note: Action is logged for audit purposes.

System Commands

/has setmainlobby

Description: Set the main lobby locationUsage: /has setmainlobbyPermission: nhideandseek.adminExample:

/has setmainlobby

Notes:

Stand at desired lobby location
Run the command
Players will be teleported here when leaving games
Includes exact coordinates and rotation
Also sets in config.yml

/has reload

Description: Reload plugin configurationUsage: /has reloadPermission: nhideandseek.adminExample:

/has reload

What Gets Reloaded:

Main configuration (config.yml)
Language files
Effects configuration
Menu configurations
Arena settings

Notes:

Does not interrupt active games
Players in games are not affected
New settings apply to next game
Database connection is not reloaded

Use this to apply configuration changes without restarting the server!

Permissions

Complete permission node reference for NHideAndSeek.

Permission Structure

nhideandseek.*                    # All permissions
nhideandseek.admin                # All admin commands
nhideandseek.effect.*             # All effects unlocked
nhideandseek.effect.<effectid>    # Specific effect access

Player Permissions

Permission	Description	Default
`nhideandseek.join`	Join games	`true`
`nhideandseek.leave`	Leave games	`true`
`nhideandseek.menu`	Open arena menu	`true`
`nhideandseek.stats`	View statistics	`true`
`nhideandseek.leaderboard`	View leaderboard	`true`
`nhideandseek.effects`	Access effects shop	`true`
`nhideandseek.chat`	Toggle chat modes	`true`

Default permissions are granted to all players automatically.

Admin Permissions

Permission	Description	Default
`nhideandseek.admin`	All admin commands	`op`
`nhideandseek.create`	Create arenas	`op`
`nhideandseek.delete`	Delete arenas	`op`
`nhideandseek.editor`	Arena editor mode	`op`
`nhideandseek.settings`	Modify arena settings	`op`
`nhideandseek.forcestart`	Force start games	`op`
`nhideandseek.forcestop`	Force stop games	`op`
`nhideandseek.setrole`	Assign player roles	`op`
`nhideandseek.coins`	Manage player coins	`op`
`nhideandseek.resetstats`	Reset player stats	`op`
`nhideandseek.reload`	Reload plugin	`op`

Effect Permissions

Effect permissions allow VIP/Premium players to access exclusive cosmetic effects.

Permission	Description
`nhideandseek.effect.*`	Access all effects (bypass shop)
`nhideandseek.effect.fireworks`	Fireworks victory effect
`nhideandseek.effect.hearts`	Hearts win effect
`nhideandseek.effect.rainbow`	Rainbow circle effect
`nhideandseek.effect.star`	Star celebration effect
`nhideandseek.effect.blood`	Blood splash kill effect
`nhideandseek.effect.fire`	Fire explosion effect
`nhideandseek.effect.lightning`	Lightning strike effect
`nhideandseek.effect.smoke`	Smoke cloud effect
`nhideandseek.effect.soul`	Soul ascension death effect
`nhideandseek.effect.angel`	Angel wings effect
`nhideandseek.effect.ghost`	Ghost fade effect
`nhideandseek.effect.explosion`	Explosive death effect

How Effect Permissions Work:

With Permission: Effect is visible in shop but FREE (no coin cost)
Without Permission: Effect requires purchase with coins
With effect.*: All effects are free and unlocked

Example Configuration:

# In your permissions plugin (LuckPerms, etc.)
groups:
  vip:
    permissions:
      - nhideandseek.effect.fireworks
      - nhideandseek.effect.rainbow
      - nhideandseek.effect.lightning

  premium:
    permissions:
      - nhideandseek.effect.*  # All effects free

Seeker Priority Permissions

Configure VIP players to have higher chance of becoming seekers. In arena settings:

settings:
  teams:
    seeker-priority:
      enabled: true
      permissions:
        - "vip.premium"
        - "rank.elite"
      priority-weight: 3.0

How It Works:

Players with listed permissions have 3x higher chance to be seeker
Does not guarantee seeker role
Works with random assignment
Useful for giving VIPs preferred roles

For more help, check our Discord or GitHub repository!

​Command Overview

Player Commands

Admin Commands

​Player Commands

​Basic Commands

​Statistics Commands

​Shop & Effects

​Communication

​Admin Commands

​Arena Management

​Game Control

​Player Management

​System Commands

​Permissions

​Permission Structure

​Player Permissions

​Admin Permissions

​Effect Permissions

​Seeker Priority Permissions

Command Overview

Player Commands

Basic Commands

Statistics Commands

Shop & Effects

Communication

Admin Commands

Arena Management

Game Control

Player Management

System Commands

Permissions

Permission Structure

Player Permissions

Admin Permissions

Effect Permissions

Seeker Priority Permissions