Portbay Retail

🛡️ Moderator (Level 1)

• Warn players
• Kick players
• View player profiles
• See recent activity
• Use basic commands

⭐ Admin (Level 2)

• Everything Moderators can do
• Add notes to player profiles
• Clear warnings
• Access player monitoring
• Use teleport commands
• Modify player stats (speed, jump, etc.)

💎 Super Admin (Level 3)

• Everything Admins can do
• Ban/unban players
• Advanced moderation actions
• Full command access
• Manage staff roles

🔧 Developer (Level 4)

• Everything Super Admins can do
• Change user permissions
• Manage VIP+ users
• Access control panel
• Configure system settings

👑 Owner (Level 5)

• Complete system control
• All features unlocked
• Animated theme effects
• Final authority on all actions

📊 Account Standing

• Visual indicator of player behavior
• All Good 🟢 - 0-6 actions (green)
• Limited 🟡 - 7-12 actions (yellow)
• Very Limited 🟠 - 13-19 actions (orange)
• At Risk 🔴 - 20-29 actions (red)
• Suspended ⛔ - 30+ actions (dark red, auto-banned)

⚡ Quick Actions

Available actions based on player status:

For Online Players:

• 🚪 Kick - Remove from server
• ⚠️ Warn - Issue warning
• 🚫 Ban - Permanently ban
• 📝 Note - Add staff note
• 🧹 Clear Warns - Remove all warnings (Level 4+)

For Banned Players:

• 🔓 Unban - Remove ban
• 📋 View Ban - See ban details
• 🧹 Clear Warns - Clear warnings (Level 4+)
• 📝 Note - Add staff note

📋 Moderation Logs

• Complete history of all moderation actions
• Shows: Action type, executor, reason, date/time
• Automatically scrolls to latest
• Preserved even when player is offline

📝 Staff Notes

Internal notes visible only to admins

Use for:

• Behavior observations
• Context for warnings
• Follow-up reminders
• Team communication

How to Add a Note:

1. Click 📝 Note in Quick Actions
2. Type your note (be clear and professional)
3. Click Add Note
4. Note appears with your name and timestamp

📊 Detailed View (Default)

Shows comprehensive analysis:

1. Violation Breakdown

• ⚠️ Total Warnings
• 🚪 Total Kicks
• 🚫 Total Bans
• 🕐 Recent (Last 7 Days)

2. Behavior Patterns

• ● Repeated Offenses - Multiple violations of same type
• ● Escalating Behavior - Progression from warnings to kicks/bans
• ● Recent Activity - Spike in recent violations
• ● High Frequency - Unusually high total count

3. Recommended Actions

Smart suggestions based on patterns:

• 🚫 Temporary Ban (High Severity) - Multiple violations with escalation
• ⚠️ Final Warning (Medium) - Recent spike in warnings
• 🚪 Kick (Medium) - Warnings without enforcement
• 👁️ Monitor Closely (Low) - Pattern of minor violations
• 🔨 Permanent Ban (Critical) - 15+ total actions

📋 Brief View

Quick summary mode showing:

• Total violation count breakdown
• Primary recommendation highlighted
• Quick action buttons (Warn, Kick, Ban)

Warning Players

When to Warn:

• First-time minor rule breaks
• Borderline behavior
• As a documented reminder
• Before escalating to kick/ban

How to Warn:

1. Open player profile
2. Click ⚠️ Warn
3. Enter clear, specific reason (e.g., "Spamming chat after request to stop")
4. Click Confirm

Best Practices:

• Be specific about what rule was broken
• Explain expected behavior
• Keep tone professional
• Document context in notes

Kicking Players

When to Kick:

• After multiple warnings
• Moderate rule violations
• Disruptive behavior
• Need immediate removal without permanent ban

How to Kick:

1. Open player profile or use command
2. Click 🚪 Kick or type :kick [player] [reason]
3. Enter reason
4. Confirm

What Happens:

• Player immediately removed from server
• Can rejoin immediately
• Kick logged in moderation history
• All online admins notified

Banning Players

When to Ban:

• Severe rule violations
• Repeated offenses after warnings/kicks
• Account standing reaches Suspended (30+ actions)
• Threats, harassment, exploiting

Types of Bans:

• Manual Ban - Staff member initiates
• Auto-Ban - System triggers at 30+ actions

How to Ban:

1. Open player profile
2. Click 🚫 Ban
3. Enter detailed reason (this will be shown to player)
4. Click Confirm Ban

Ban Dialog Shows:

• Player information
• Current account standing
• Warning if player is already suspended

What Happens:

• Player immediately kicked if online
• Cannot rejoin server
• Ban recorded with: reason, staff member, timestamp
• Visible to all admins level 2+

Unbanning Players

Who Can Unban:

• Super Admins (Level 3+)
• Auto-unbans if warnings cleared and actions drop below 30

How to Unban:

1. Search for player by UserID or check ban list
2. Open their profile (shows as banned)
3. Click 🔓 Unban
4. Confirm

Auto-Unban Triggers:

• Admin clears warnings
• Total actions drop below 30
• Player was banned by SYSTEM (auto-ban)

Clearing Warnings

Who Can Clear:

• Super Admins and above (Level 4+)

When to Clear:

• Player reformed behavior over time
• False warnings identified
• As part of appeal process
• To prevent auto-ban

How to Clear:

1. Open player profile
2. Click 🧹 Clear Warns
3. Confirm action

What Happens:

• All warnings removed from history
• Account standing recalculated
• If total actions drop below 30 and player was auto-banned, they're automatically unbanned
• Action logged in moderation history

Important:

• Cannot be undone
• Only removes warnings, not kicks/bans from logs
• Consider carefully before using

Adding Staff Notes

Purpose:

• Document context
• Track ongoing situations
• Communicate between staff
• Record verbal warnings

How to Add:

1. Click 📝 Note in player profile
2. Type note content
3. Click Add Note

Note Format:

Note: "Player warned verbally about language - monitor for improvement"
By: YourUsername
Date: 11/30/2025
Time: 15:30:45

Best Practices:

• Be clear and professional
• Include relevant context
• Date important conversations
• Use for patterns, not single events

🛡️ Moderation Commands

👤 Player Commands

🌀 Teleport Commands

📊 Information Commands

Keybind Customization

Changing Your Keybind:

1. Go to Settings
2. Find "Open/Close Keybind" section
3. Click the keybind button
4. Press any key on your keyboard
5. New keybind saves automatically

Recommended Keys:

• ; (Semicolon) - Default
• ' (Quote)
• / (Slash)
• - (Minus)

Note: Avoid gameplay keys (WASD, Space, Shift, etc.)

Theme Customization

Available Themes:

• Midnight 🌙 - Deep blue with purple accents
• Obsidian 🖤 - Pure black with purple highlights
• Ocean 🌊 - Teal and cyan theme
• Crimson ❤️ - Dark red theme
• Forest 🌲 - Green nature theme
• Sunset 🌅 - Orange and pink gradients
• Galaxy 🌌 - Purple space theme
• Monochrome ⚫ - Black and white

Changing Themes:

1. Go to Settings (or click theme icon in header)
2. Scroll to theme section
3. Click any theme to preview
4. Changes apply instantly
5. Preference saves automatically

Owner Special: Level 5 gets animated gradient themes!

Accessibility Features

Text Size Options:

• S - Small (0.8x)
• N - Normal (1.0x) - Default
• L - Large (1.2x)
• XL - Extra Large (1.5x)
• XXL - Huge (2.0x)

How to Change:

1. Go to Settings
2. Find "Accessibility" section
3. Click size button (S/N/L/XL/XXL)
4. Notification appears
5. Refresh panel (close and reopen) to apply

Font Style Options:

• Gotham - Clean, modern (default)
• GothamBold - Bold version
• SourceSans - Friendly, readable
• SourceSansBold - Bold Source Sans
• RobotoMono - Monospace, code-like
• Code - Terminal style

How to Change Font:

1. Go to Settings
2. Find "Font Style" section
3. Click font name to select
4. Preview shows in button
5. Refresh panel to apply

Why Accessibility Matters:

• Improves readability for all users
• Helps users with visual impairments
• Allows customization for comfort
• Makes long sessions easier

Admin Management

Viewing Admin List:

• See all users with permissions
• Grouped by permission level
• Shows username and UserID

Managing Permissions:

• Click user to expand options
• Change permission level
• Remove permissions entirely

Adding New Admins:

1. Enter UserID or username
2. Select permission level
3. Click Add Admin
4. User immediately gains access

Removing Admins:

1. Find user in list
2. Click Remove
3. Confirm action
4. User loses access immediately

Staff Role Management

What are Staff Roles?

Visual roles that appear above players' heads in-game (separate from admin permissions).

Creating Roles:

1. Go to Role Templates
2. Click Create New Role
3. Configure:
   • Role name
   • Color (RGB)
   • Icon/emoji
   • Maximum users (optional)

Assigning Roles:

1. Select player
2. Choose role from template
3. Click Assign
4. Billboard appears above player

Role vs Permission:

• Permission = What you can do (commands, features)
• Role = Visual display only (cosmetic)

Use Cases:

• VIP donors
• Event staff
• Trainers
• Support team

Data Management

Viewing System Data:

• Total bans
• Total warnings issued
• Command usage statistics
• Join/leave history

Backup Options:

• Manual save trigger
• Data export (if available)

General Moderation Principles

The Warning Ladder:

• 1st Offense → Verbal warning (note it)
• 2nd Offense → Formal warning (:warn)
• 3rd Offense → Kick
• 4th+ Offense → Consider ban

Context Matters:

• Severity of rule break
• Player's history
• Intent vs accident
• Age/maturity of player

Documentation is Key

Always Document:

• Reasons for warns/kicks/bans
• Context of situations
• Player responses
• Team discussions about edge cases

Good Reason Examples:

• ✅ "Spamming chat after 2 warnings to stop"
• ✅ "Using exploits to gain unfair advantage"
• ✅ "Harassment - making targeted insults after multiple requests to stop"

Bad Reason Examples:

• ❌ "Being annoying"
• ❌ "Bad"
• ❌ "You know what you did"

Team Communication

Share Information:

• Notify team of major bans
• Ask for second opinions on edge cases
• Report patterns you notice
• Coordinate on ongoing situations

Use Staff Notes:

• Leave context for next shift
• Track multi-day situations
• Document verbal discussions
• Note player promises/agreements

Player Relations

Stay Professional:

• Remain calm and respectful
• Don't argue or debate
• Explain decisions briefly
• Don't take insults personally

Be Fair:

• Apply rules consistently
• Don't favor friends
• Give everyone same treatment
• Admit and correct mistakes

Show Restraint:

• Don't abuse admin powers
• Use minimum necessary action
• Give players chance to improve
• Remember you represent the team

Monitoring Best Practices

Use the System:

• Check monitoring alerts daily
• Review flagged players
• Follow recommendation severity
• Track improvement over time

Don't Over-Rely:

• Numbers aren't everything
• Consider context and intent
• Some players reform
• Fresh starts matter

Pattern Recognition:

• Notice escalation
• Identify repeat offenders
• Spot coordinated rule breaking
• Track time-based patterns

Security Practices

Protect Access:

• Don't share passwords
• Don't give permissions lightly
• Report suspicious admin behavior
• Log out on shared devices

Verify Before Action:

• Confirm player identity
• Double-check UserIDs
• Verify evidence
• Get proof when possible

Common Issues

Error Messages

Performance Tips

If Panel is Laggy:

• Close other browser tabs/apps
• Reduce player count in view
• Switch to simpler theme
• Check computer performance

If Commands are Slow:

• Server might be under load
• Wait a few seconds between commands
• Check server ping/latency
• Report to owner if chronic

Getting Help

Support Chain:

1. This guide - Check relevant section
2. Team members - Ask experienced admins
3. Developers - Report bugs/issues
4. Owner - Final authority

When Reporting Issues:

• Describe what you were doing
• Note any error messages
• Mention your permission level
• Include screenshots if possible
• Say if it's repeatable

Frequently Asked Questions

END OF STAFF GUIDE

Version 2.2.0 - Last Updated: November 30th 2025

For support, contact your server administrator