Skip to content

Commands

Aorux01 edited this page Feb 18, 2026 · 6 revisions

Command System

Neodyme features a comprehensive command system that allows server administrators to manage and monitor the server in real-time through the console.

Version: 1.2.3

Command List

Server Information Commands

/help [page]

Displays all available commands with pagination.

/help      # Show first page of commands
/help 2    # Show second page

/uptime

Shows how long the server has been running.

/uptime
# Output: Server Uptime: 2h 15m 30s

/memory

Displays current memory usage.

/memory
# Output: Memory usage: 245MB

/version

Shows the current Neodyme version.

/version
# Output: Neodyme Version: 1.2.0

/health

Performs a comprehensive health check of all server components.

/health
# Output: Server Health Check:
#          Database: Connected (JSON)
#          XMPP Server: Running
#          Web Interface: Enabled
#          Memory: 245MB (OK)
#          Uptime: 2h 15m 30s
#          Overall Status: HEALTHY

/ready

Quick readiness check to verify the server is accepting connections.

/ready
# Output: Server is ready and accepting connections

Server Management Commands

/reload

Reloads the server configuration without restarting.

/reload
# Output: Configuration reloaded successfully

/stop

Gracefully shuts down the server.

/stop
# Output: Shutting down server...

/clear

Clears the console and displays the Neodyme banner.

/clear

Plugin Management Commands

/plugins store list [page]

Lists all available plugins from the plugin store with pagination.

/plugins store list        # Show first page
/plugins store list 2      # Show page 2
# Output: Available plugins in store (Page 1/1) - Total: 5
#         Store version: 1.0.0 | Last updated: 11/02/2025 13:00:00
#
#         1. Discord Integration v1.0.0 [INSTALLED]
#            Enhanced Discord integration features
#            Author: Aorux [Official Plugin] | Category: integration | Downloads: 523
#            ID: discord-integration

/plugins store search <query>

Searches for plugins by name, description, author, or tags.

/plugins store search discord
# Output: Searching for: "discord"...
#         Found 1 plugin(s):
#         1. Discord Integration v1.0.0
#            Enhanced Discord integration features
#            ID: discord-integration

/plugins store info <plugin-id>

Shows detailed information about a plugin from the store.

/plugins store info discord-integration
# Output: Discord Integration v1.0.0
#         Description:        Enhanced Discord integration features
#         Author:             Aorux [Official Plugin]
#         Category:           integration
#         Version:            1.0.0
#         Min Backend:        1.2.0
#         License:            MIT
#         Downloads:          523
#         Rating:             ★★★★★ 4.8/5
#         Status:             Not installed
#         Tags:               discord, social
#         NPM Dependencies:   discord.js, axios
#         Files:              3 file(s)
#         Repository:         https://github.com/Aorux01/Neodyme-Plugins
#
#         Install with: /plugins store install discord-integration

/plugins store install <plugin-id>

Downloads and installs a plugin from the store with progress bar.

/plugins store install discord-integration
# Output: Installing plugin: Discord Integration v1.0.0
#         Author: Aorux [Official Plugin]
#         Description: Enhanced Discord integration features
#         Fetching plugin manifest...
#         Downloading 3 file(s)...
#           index.js: ██████████████████████████████ 100% (32.66 KB / 32.66 KB)
#         ✓ Downloaded: index.js (1/3)
#           config.json: ██████████████████████████████ 100% (1.89 KB / 1.89 KB)
#         ✓ Downloaded: config.json (2/3)
#           README.md: ██████████████████████████████ 100% (6.44 KB / 6.44 KB)
#         ✓ Downloaded: README.md (3/3)
#         Installing npm dependencies...
#         Installing npm dependencies: discord.js, axios
#           added 2 packages in 3s
#         Dependencies installed successfully
#         Loading plugin...
#         ✓ Plugin 'Discord Integration' installed and loaded successfully!

/plugins store uninstall <plugin-id>

Uninstalls a plugin installed from the store.

/plugins store uninstall discord-integration
# Output: Unloading plugin...
#         Unloaded plugin: discord-integration
#         Plugin 'discord-integration' uninstalled successfully

/plugins store update <plugin-id>

Updates an installed plugin to the latest version.

/plugins store update discord-integration
# Output: Updating plugin: discord-integration
#         Unloading plugin...
#         Installing plugin: Discord Integration v1.1.0
#         ...
#         ✓ Plugin 'Discord Integration' installed and loaded successfully!

/plugins store refresh

Refreshes the plugin store cache to fetch the latest plugin list.

/plugins store refresh
# Output: Refreshing plugins store cache...
#         Store cache refreshed successfully

/plugins list

Lists all currently loaded plugins with their versions.

/plugins list
# Output: Loaded plugins (2):
#          - discord-integration v1.0.0
#          - welcome-message v1.0.0

/plugins load <pluginName|all>

Loads a specific plugin or all plugins from the plugins directory.

/plugins load discord-integration   # Load single plugin
/plugins load all                   # Load all plugins

/plugins unload <pluginName|all>

Unloads a specific plugin or all plugins.

/plugins unload discord-integration  # Unload single plugin
/plugins unload all                  # Unload all plugins

/plugins reload <pluginName|all>

Reloads a specific plugin or all plugins.

/plugins reload discord-integration  # Reload single plugin
/plugins reload all                  # Reload all plugins

/plugins info <pluginName>

Shows detailed information about a currently loaded plugin.

/plugins info discord-integration
# Output: Plugin Information: discord-integration
#          Version:            1.0.0
#          Description:        Enhanced Discord integration features
#          Author:             Aorux - Neodyme Team
#          License:            MIT
#          Min Backend Ver:    1.2.0
#          NPM Dependencies:   discord.js, axios
#          Path:               plugins/discord-integration/index.js
#          Repository:         https://github.com/Aorux01/Neodyme-Plugins
#          Homepage:           https://github.com/Aorux01/Neodyme-Plugins#readme

Account Management Commands

/createaccount <email> <password> <displayName>

Creates a new player account.

/createaccount player@example.com password123 "Cool Player"
# Output: Account created successfully!
#          Email: player@example.com
#          Display Name: Cool Player
#          Account ID: abc123...

/admin set <username> <role>

Sets a player's role with various staff levels.

/admin set "Cool Player" admin       # Set as Admin
/admin set "Cool Player" 2           # Set as Admin (by ID)
/admin set "Cool Player" moderator   # Set as Moderator
/admin set "Cool Player" helper      # Set as Helper
/admin set "Cool Player" founder     # Set as Founder
/admin set "Cool Player" 0           # Remove role (regular player)

Available Roles:

  • 0 or player - Regular player (no prefix)
  • 1 or founder - Founder [FOUNDER] (Purple)
  • 2 or admin - Administrator [ADMIN] (Red)
  • 3 or moderator (or mod) - Moderator [MODERATOR] (Yellow)
  • 4 or helper - Helper [HELPER] (Cyan)
  • 5 or developer (or dev) - Developer [DEVELOPER] (Blue)

/admin list

Lists all staff members grouped by role.

/admin list
# Output: Found 5 staff member(s):
#
#         [ADMIN] (2):
#           1. Cool Player
#           2. Server Owner
#
#         [MODERATOR] (2):
#           1. Mod123
#           2. Mod456
#
#         [HELPER] (1):
#           1. Helper1

/account create <email> <password> <displayName>

Creates a new player account (alternative to /createaccount).

/account create player@example.com password123 "Cool Player"
# Output: Account created successfully!
#          Email: player@example.com
#          Display Name: Cool Player
#          Account ID: abc123...

/account info <username>

Shows detailed account information (alternative to /player).

/account info "Cool Player"
# Output: Account information for "Cool Player":
#          Account ID: abc123...
#          Email: player@example.com
#          Role: Player
#          V-Bucks: 1500
#          Created: 2024-01-10 09:15:00

/account list

Lists all registered accounts.

/account list
# Output: Found 150 registered account(s):
#          1. Cool Player (player@example.com) - Player
#          2. Server Owner (owner@example.com) - Admin
#          ... (showing first 25)

/unlock <username>

Unlocks an account that was locked due to failed login attempts.

/unlock "LockedPlayer"
# Output: Account "LockedPlayer" has been unlocked

Token Management Commands

/tokens stats

Displays statistics about active tokens.

/tokens stats
# Output: Token Statistics:
#          Active access tokens: 45
#          Active refresh tokens: 38
#          Web sessions: 12
#          CSRF tokens: 28

/tokens cleanup

Forces cleanup of expired tokens.

/tokens cleanup
# Output: Token cleanup completed:
#          Removed 15 expired access tokens
#          Removed 8 expired refresh tokens
#          Removed 23 expired CSRF tokens

/tokens revoke <accountId>

Revokes all tokens for a specific account.

/tokens revoke abc123-def456-ghi789
# Output: All tokens revoked for account abc123-def456-ghi789

/tokens user <username>

Shows token information for a specific user.

/tokens user "Cool Player"
# Output: Tokens for "Cool Player" (abc123...):
#          Access tokens: 2
#          Refresh tokens: 1
#          Web sessions: 1
#          Last token issued: 2024-01-15 14:30:00

Shop Management Commands

/shop rotate

Forces immediate shop rotation.

/shop rotate
# Output: Shop has been rotated successfully!

/shop info

Shows current shop items and statistics.

/shop info
# Output: Current shop contains 25 items:
#          Daily items: 12
#          Featured items: 13

/shop status

Displays shop rotation timing information.

/shop status
# Output: Last rotation: 2024-01-15 14:30:00
#          Next rotation: 2024-01-16 00:00:00
#          Time until next rotation: 9h 30m

Ban Management Commands

/ban add <username> <reason> [duration]

Bans a player with optional duration.

/ban add "BadPlayer" "Cheating"           # Permanent ban
/ban add "ToxicPlayer" "Harassment" "7d"  # 7-day ban
/ban add "Spammer" "Spamming" "2h"        # 2-hour ban

Duration formats:

  • h - Hours (e.g., 2h, 24h)
  • d - Days (e.g., 7d, 30d)
  • m - Months (e.g., 1m, 6m)
  • Omit duration for permanent ban

/ban remove <username>

Unbans a previously banned player.

/ban remove "BadPlayer"
# Output: Player "BadPlayer" has been unbanned

/ban info <username>

Shows detailed ban information for a player.

/ban info "BadPlayer"
# Output: Ban information for "BadPlayer":
#          Account ID: abc123...
#          Banned: YES
#          Banned at: 2024-01-15 10:30:00
#          Expires: PERMANENT
#          Reasons:
#            1. Cheating

/ban list

Lists all currently banned players.

/ban list
# Output: Found 3 banned player(s):
#         1. BadPlayer - Expires: PERMANENT
#            Reason: Cheating
#         2. ToxicPlayer - Expires: 2024-01-22 10:30:00
#            Reason: Harassment

Player Information Commands

/player <username>

Displays comprehensive information about a player.

/player "Cool Player"
# Output: Player information for "Cool Player":
#          Account ID: abc123...
#          Email: player@example.com
#          Role: Admin
#          Banned: NO
#          V-Bucks: 1500
#          Last login: 2024-01-15 14:25:00
#          Created: 2024-01-10 09:15:00

Backup Management Commands

/backup create

Creates a manual database backup.

/backup create
# Output: Backup created: backup-20240115-143000 (15 files, 45.2 MB)

/backup list

Lists all available backups.

/backup list
# Output: Found 3 backup(s):
#          1. backup-20240115-143000 (LATEST)
#             Size: 45.2 MB | Files: 15 | Date: 2024-01-15 14:30:00

/backup stats

Shows backup system statistics.

/backup stats
# Output: Backup Statistics:
#          - Total backups: 3
#          - Total size: 120.5 MB
#          - Backup expiry: 7 days
#          - Auto backup interval: 60 minutes
#          - Next backup: 2024-01-15 15:30:00
#          - System status: Idle

/backup restore <backup-name>

Restores a backup (requires confirmation).

/backup restore backup-20240115-143000
# Output: WARNING: You are about to restore backup: backup-20240115-143000
#         This will OVERWRITE all current data with the backup data!
#         The server will need to be restarted after restoration.
#         Type /confirm restore to confirm or anything else to cancel.

# Then confirm with:
/confirm restore

/backup delete <backup-name>

Deletes a backup (requires confirmation).

/backup delete backup-20240110-090000
# Output: You are about to delete backup: backup-20240110-090000
#         This action cannot be undone!
#         Type /confirm delete to confirm or anything else to cancel.

# Then confirm with:
/confirm delete

/backup cleanup

Forces cleanup of old backups based on expiry settings.

/backup cleanup
# Output: Backup cleanup completed

Confirmation Commands

/confirm <restore|delete>

Confirms pending backup operations.

/confirm restore    # Confirm backup restoration
/confirm delete     # Confirm backup deletion

/cancel

Cancels any pending operations.

/cancel
# Output: Cancelled pending restore: backup-20240115-143000

Usage Tips

Role Hierarchy

The role system follows this hierarchy (highest to lowest):

  1. Developer - Full access to all features including configuration
  2. Admin - Full server control, user management, audit logs
  3. Moderator - Player management, bans, tickets, creator codes
  4. Helper - Support and assistance role
  5. Founder - Special recognition role
  6. Player - Regular user

Command Auto-completion

The command system supports partial matching:

/pl list        # Same as /plugins list
/ba create      # Same as /backup create

Color-coded Output

  • Green: Success messages
  • Blue/Cyan: Information messages and command syntax
  • Yellow: Warning messages
  • Red: Error messages and critical information
  • Magenta: Founder role
  • Cyan: Helper role

Safe Operations

  • Backup operations require explicit confirmation
  • Ban operations can be temporary or permanent
  • Role changes are immediate but reversible
  • All commands include error handling and validation

Advanced Usage

Monitoring Server Health

# Quick health check
/uptime
/memory
/version

Routine Maintenance

# Daily maintenance routine
/backup create
/plugins reload all
/shop rotate
/ban list  # Check for expired bans

Player Management Workflow

# Investigate player
/player "SuspiciousPlayer"

# If needed, take action
/ban add "SuspiciousPlayer" "Suspicious activity" "1d"

# Verify action
/ban info "SuspiciousPlayer"

Staff Management

# Promote a player to helper
/admin set "NewHelper" helper

# Check all staff members
/admin list

# Promote helper to moderator
/admin set "NewHelper" moderator

# Demote back to regular player
/admin set "NewHelper" 0

Troubleshooting

Command Not Found

  • Check spelling and case sensitivity
  • Use /help to see all available commands
  • Ensure you're using the correct syntax

Role Assignment Issues

  • Verify the player exists: /player <username>
  • Use exact username (case-sensitive)
  • Valid roles: 0-4 or player/founder/admin/moderator/helper

Ban Management Issues

  • Check if player is already banned: /ban info <username>
  • Use correct duration format: 2h, 7d, 1m
  • List all bans to verify: /ban list

Backup Operation Failures

  • Ensure sufficient disk space
  • Check write permissions in backup directory
  • Verify backup name exists: /backup list

Notes

  • All commands are executed in real-time and affect the running server
  • Most commands provide immediate feedback with color-coded responses
  • Critical operations (like backup restore) require confirmation for safety
  • The role system allows for granular permission management
  • Bans can be temporary or permanent with automatic expiry handling
  • The command system is designed to be intuitive and developer-friendly

Role Display in Game

Players with roles will have their role displayed as a prefix:

  • [DEVELOPER] PlayerName
  • [ADMIN] PlayerName
  • [MODERATOR] PlayerName
  • [HELPER] PlayerName
  • [FOUNDER] PlayerName
  • PlayerName - No prefix for regular players

The command system provides complete server management without needing to restart or modify configuration files manually!

Clone this wiki locally