Player Settings

Overview

The Player Settings system is a comprehensive customization hub where players can manage their PadawanForge experience, profile, and gameplay preferences. This sophisticated system includes role-based progression, experience points, avatar management, and four main settings categories designed around the game’s forge theme.

Core Features

Player Profile Management

  • Dynamic Profile Card: Rich profile display showing level, experience, role, and achievements
  • Avatar Upload System: Custom avatar uploads with OAuth fallback and default options
  • Profile Editing: Players can edit their display name, birthday, location, gender, and other profile fields directly from the settings interface
  • Profile Export for NPC Audience: Players can export their profile as an “audience” configuration for use in NPC AI settings, enabling personalized NPC interactions
  • Role Progression: Hierarchical system from Guest → Padawan → Game Master → Guild Leader → System Admin
  • Experience & Levels: XP-based progression with visual level indicators and progress bars
  • Achievement Badges: Tutorial completion, profile completion, and veteran player recognition

Role-Based System

The platform uses a game-themed role hierarchy:

  • Guest (Level 0): Temporary demo access with 24-hour expiration
  • Padawan (Level 1+): Standard registered players with basic game access
  • Game Master (Level 10+): Experienced moderators who guide and assist learners
  • Guild Leader (Level 25+): Advanced administrators managing community and systems
  • System Admin (Level 50+): Master administrators with complete authority

Settings Categories

1. Alert Preferences

Configure your notification system for optimal gameplay:

  • Chat Messages: Receive notifications for new chat messages and mentions
  • NPC Interactions: Get notified when NPCs respond to your messages
  • Level Up Celebrations: Celebrate when you gain a new level or achievement

XP Reward: 15 XP for completing this section

2. Privacy Shield

Secure your personal information and control visibility:

  • Show Online Status: Let other players see when you’re active in the forge
  • Show Experience: Display your level and experience to other players
  • Allow Direct Messages: Let other players send you private messages

XP Reward: 20 XP for completing this section

3. Interface Customization

Personalize your PadawanForge experience:

  • Theme Selection: Choose between System (Auto), Light Mode, or Dark Mode
  • Chat Font Size: Adjust text size (Small, Medium, Large) for better readability
  • Reduce Motion: Minimize animations and transitions for better performance

XP Reward: 15 XP for completing this section

4. Gameplay Preferences

Configure your gameplay experience and optimize performance:

  • Auto-join Game Lobby: Automatically join the main lobby when you log in
  • Show Player Count: Display how many players are online in the forge
  • Sound Effects: Play sounds for notifications and game actions
  • Tutorial Completed: Mark tutorial as completed to unlock advanced features

XP Reward: 25 XP for completing this section

Technical Implementation

API Integration

  • Endpoint: /api/user/preferences (GET/PATCH)
  • Profile Editing Endpoint: /api/players/[uuid] (GET/PUT) for updating profile fields
  • Authentication: Requires valid player session
  • Data Persistence: Preferences stored in player_preferences table; profile data in players table
  • Real-time Updates: Changes applied immediately with success/error feedback

User Interface Features

  • Responsive Design: Optimized for desktop, tablet, and mobile devices
  • Mobile Navigation: Horizontal scrolling tab interface for small screens
  • Profile Editing Form: Dedicated section for editing display name, birthday, location, gender, and more
  • Profile Export Button: One-click export of player profile as an audience config for NPCs (JSON/text format, copy to clipboard)
  • Progress Tracking: Visual progress indicators and XP rewards
  • Error Handling: Comprehensive error display with user-friendly messages
  • Loading States: Skeleton loading and smooth transitions
  • Touch-Friendly: Optimized for mobile touch interactions

User Workflows

Initial Setup Process

  1. Authentication: Player must be logged in to access settings
  2. Profile Card: View current player information, level, and role
  3. Mobile Navigation: Use horizontal tabs on mobile to navigate between sections
  4. Desktop Navigation: Sections auto-expand based on interaction

Profile Customization & Editing

  1. Avatar Management:
    • Click on avatar in profile card to upload custom image
    • Fallback to OAuth provider avatar or default initials
    • Real-time preview of avatar changes
  2. Edit Profile:
    • Access the Profile section to edit display name, birthday, location, gender, and other fields
    • Save changes to update your public profile
  3. Profile Expansion: Click chevron to view detailed player information
  4. Achievement Display: View earned badges and completion status

Export Profile as Audience for NPCs

  1. Export Audience:
    • In the Profile section, click the “Export as Audience” button
    • A JSON or text block representing your profile will be generated (e.g., { name, level, achievements, interests, ... })
    • Use the “Copy to Clipboard” feature to copy the export for use in NPC configuration
  2. NPC Configuration:
    • Paste the exported audience config into the NPC’s audience field to personalize AI interactions

Settings Management

  1. Section-by-Section: Each category has its own save button for granular control
  2. Form Validation: Required fields highlighted, progress tracking shown
  3. Immediate Feedback: Toast notifications for successful saves or errors
  4. XP Rewards: Experience points awarded for completing sections

Progress Tracking

  • Overall Progress: Track completion across all settings sections
  • XP Accumulation: Earn experience points for configuring preferences
  • Achievement Unlocks: Special recognition for completing all sections
  • Visual Indicators: Progress bars and completion badges throughout interface

Mobile Experience

Responsive Design Features

  • Horizontal Tab Navigation: Touch-friendly scrolling interface for section selection
  • Optimized Typography: Scalable text sizes for different screen sizes
  • Touch Interactions: Active scaling effects and proper touch targets
  • Gesture Support: Smooth scrolling and intuitive navigation

Mobile-Specific Optimizations

  • Compact Layout: Efficient use of screen space
  • Thumb-Friendly Controls: Buttons and switches positioned for easy access
  • Reduced Animation: Option to minimize motion for performance
  • Offline Indication: Clear feedback when network requests fail

Error Handling & Validation

Form Validation

  • Required Fields: Clear indication of mandatory settings
  • Real-time Validation: Immediate feedback on invalid inputs
  • Error Display: Prominent error banner with specific error messages
  • Recovery Guidance: Clear instructions for resolving validation errors

Network Error Handling

  • Connection Issues: Graceful degradation when API calls fail
  • Retry Logic: Automatic retry for failed preference saves
  • User Feedback: Clear messaging about network status and retry options
  • Data Persistence: Local form state maintained during network issues

Future Enhancements

Planned Improvements

  • Advanced Privacy Controls: More granular visibility settings
  • Custom Themes: User-created color schemes and interface themes
  • Notification Scheduling: Time-based notification preferences
  • Export/Import: Settings backup and restoration functionality
  • Social Features: Friend lists and social privacy controls

Integration Opportunities

  • Game Mechanics: Settings that affect gameplay balance and features
  • Admin Tools: Enhanced controls for administrative roles
  • Analytics: Player behavior insights for system optimization
  • Accessibility: Enhanced screen reader and keyboard navigation support

Last updated: January 2025 - Comprehensive documentation reflecting current v1.2.1 implementation, including profile editing and export as audience for NPC AI config

← Permissions & Role-Based Access Control Player System & Role-Based Access →
PadawanForge v1.4.1