MAS Documentation

Table of Contents
Version History
Understanding Version Numbers

We follow semantic versioning (SemVer) to help you understand the impact of each update.

Major Version (X.0.0)

Breaking changes that may require action from users. New major features, complete redesigns, or changes that break existing functionality.

Example: 2.8.0 → 3.0.0
Minor Version (0.X.0)

New features added in a backward-compatible manner. Enhancements and improvements that don't break existing functionality.

Example: 3.0.0 → 3.1.0
Patch Version (0.0.X)

Bug fixes and minor improvements. Backward-compatible fixes that address issues without adding new features.

Example: 3.1.0 → 3.1.1
  • Places: banned / suspended owners: Places list and Edit Place now flag games whose MAS owner has an active ban or suspended account. Admins can filter Owners banned / suspended and jump to the owner account, latest ban, or deactivate the place for cleanup.
  • View Bans: owns MAS places: Ban rows and the single ban view show when a banned player owns MAS places (matched by Roblox ID or username), with staff links to Edit Place and the owner account.
  • Bans list pagination: /bans defaults to 10 results per page, with 10/25/50/100 dropdown, page numbers, and Go to page (same pattern as View Bans and Admin Roles).
  • API docs moved: Inline API documentation removed from the Bans page. HTTP Check User Bans docs now live under Documentation → API alongside WebhookService reference.
  • Sidebar cleanup: Removed the New/Unassigned accordion. Pages stay off the sidebar until assigned under Settings → Navigation access.
  • View Bans filters: Scope filters for All accessible, Games I own, and Groups I am in, plus game dropdown and pagination (per page + Go to).
  • Admin Roles pagination: User Role Manager defaults to 10 per page with 10/25/50/100 and Go to page, preserving search.
  • Live Moderation: Modularized cache/actions/cards; Resolve / Reject / Clear for offline servers; Discord notify best-effort; modcall_clear API for BindToClose cleanup.
  • Statistics: Fixed Chart.js syntax errors; charts always render (bans by month, history, roles, plans); new Places & Live summary card; guarded duplicate futuristic-utils loads.
  • Dark mode contrast: Theme variables apply for body.dark-mode (not only [data-theme="dark"]); clearer pagination contrast on moderated lists.
  • Documentation refresh: All Documentation tabs updated for v3.9 workflows; fixed code blocks that collapsed onto one line in dark mode.
  • Complete Newsletter System Implementation: Implemented comprehensive newsletter management system with double opt-in verification, email templates, subscriber management, and campaign functionality. All features integrated into site settings for streamlined management.
  • Advanced Email Verification: Double opt-in system with configurable 24-hour verification window. Automatic cleanup of unverified subscriptions through cron job automation with detailed activity logging.
  • User Account Linking: Intelligent linking of newsletter subscriptions to existing user accounts based on email matching. Enhanced user profile integration with dedicated newsletter management tab.
  • Comprehensive Activity Logging: Enhanced activity logging system with detailed newsletter signup, verification, and cleanup tracking. Improved logging for guest users and registered users with proper user type detection.
  • Automated Cleanup System: Implemented cron job for automatic deletion of unverified newsletter subscriptions after 24 hours. Includes comprehensive logging and email cleanup for improved data hygiene.
  • Enhanced Site Settings Integration: Newsletter management fully integrated into site settings with dedicated tab. Overview dashboard with live statistics, quick actions, and comprehensive configuration options.
  • Advanced Email Configuration: Configurable sender settings, message templates, and verification requirements. Support for both guest and registered user signups with intelligent user detection.
  • Improved Error Handling: Enhanced error handling throughout the newsletter system with proper validation, user feedback, and fallback mechanisms. Resolved all JavaScript conflicts and loading issues.
  • Security & Privacy Enhancements: CAPTCHA failure and guest user action logging moved exclusively to activity log for improved privacy. Cleaned up error logs to focus on actual system errors.
  • Mobile-Friendly Interface: Fully responsive newsletter management interface with modern UI design. Optimized for all devices with touch-friendly controls and accessibility features.
  • Database Optimization: Optimized newsletter database schema with proper indexing and foreign key relationships. Enhanced data integrity and performance for large subscriber lists.
  • Testing & Quality Assurance: Comprehensive testing of all newsletter features with 0% error tolerance. Fixed all JavaScript conflicts, loading issues, and database connection problems.
  • Dark Mode System Fixes: Resolved critical dark mode functionality issues across all pages. Dark mode now works consistently on index.php, all pages/, and site_settings.php with proper toggle functionality.
  • JavaScript Loading Optimization: Added darkmode.js to header.php to ensure dark mode functionality is available on all pages that use the header template. Fixed missing script loading that was preventing dark mode from working.
  • Bootstrap Loading Improvements: Updated Bootstrap loading to use bundle.min.js with integrity checks for better reliability. Replaced separate Popper.js and Bootstrap.js loading with single bundle to prevent loading conflicts.
  • Vendor.js Error Resolution: Implemented comprehensive error handling for vendor.js promise rejections and async response errors. Added global error handlers to prevent vendor.js errors from breaking functionality.
  • Cross-Site Script Loading: Fixed parser-blocking cross-site script loading issues by using proper integrity attributes and crossorigin settings for external CDN resources.
  • Async Response Error Handling: Added specific error handlers for asynchronous response errors that were causing console errors. Prevents message channel closed errors from breaking user experience.
  • Site Settings Integration: Added darkmode.js, futuristic-design.css, and futuristic-utils.js to site_settings.php to ensure consistent dark mode and design system across all pages.
  • Global Error Prevention: Implemented global error and unhandledrejection event listeners to catch and prevent vendor.js related errors from appearing in console and breaking functionality.
  • Dark Mode Toggle Reliability: Enhanced dark mode toggle system with proper event delegation and fallback mechanisms. All dark mode toggles now work consistently across different page structures.
  • Console Error Cleanup: Eliminated all vendor.js related console errors and warnings. Clean console output with no JavaScript errors affecting user experience.
  • Cross-Page Consistency: Ensured dark mode state is properly maintained and applied across all pages. Dark mode preference is now consistently applied regardless of which page is accessed.
  • Performance Improvements: Optimized script loading order and reduced redundant script inclusions. Better page load performance with proper resource management.
  • Futuristic Design System Implementation: Complete overhaul of the MAS Admin interface with modern, glassmorphism-based design system. Applied across all major pages including dashboard, users, places, bans, statistics, profile, announcements, API keys, and badges.
  • Hero Section Stability: Fixed critical issue where hero section was fading away on scroll. Hero section now remains completely static and visible at all times, providing consistent user experience.
  • Glassmorphism Cards: Implemented glass-card class with transparent backgrounds, blur effects, and subtle borders. All major content areas now use modern glassmorphism styling for premium appearance.
  • Gradient Button System: Created btn-futuristic class with beautiful gradient backgrounds and hover effects. Multiple gradient variants (primary, secondary, danger, warning, info) for different action types.
  • Animated Elements: Added animate-on-scroll class with smooth fade-in animations. Elements animate as they enter viewport with JavaScript fallbacks for accessibility.
  • Futuristic Tables: Enhanced table styling with table-futuristic class. Improved spacing, hover effects, and readability across all data tables.
  • Enhanced Forms: Implemented form-control-futuristic class with better focus states and improved contrast for accessibility.
  • Footer Separator: Added animated gradient line with shimmer effect to provide visual separation between content and footer.
  • Toast Notifications: Integrated comprehensive toast notification system for user feedback. Success, error, info, and warning notifications with smooth animations.
  • Loading States: Added smooth loading animations and better perceived performance across all interactive elements.
  • Mobile-First Design: Fully responsive design system that works perfectly across all devices. Touch-friendly interactions and mobile-optimized layouts.
  • Accessibility Enhancements: High contrast support, reduced motion preferences respected, and screen reader friendly design patterns.
  • Database Error Resolution: Fixed critical foreign key constraint violations in user activity logging. Guest user actions now log properly without causing database errors.
  • PHP Error Cleanup: Resolved all undefined variable warnings and missing function errors. Clean, error-free operation across all pages.
  • Performance Optimizations: Optimized CSS and JavaScript loading with proper fallbacks and progressive enhancement.
  • Cross-Browser Compatibility: Modern CSS with fallbacks ensuring consistent appearance across all browsers and devices.
  • Documentation Updates: Updated all documentation to reflect new design system, accessibility features, and user experience improvements.
  • Critical Navbar Fixes: Resolved critical navbar functionality issues that prevented navigation and dropdown access. Fixed CSS overflow conflicts, z-index problems, and JavaScript initialization errors that were blocking all navigation.
  • CSS Overflow Resolution: Fixed critical CSS issue where navbar had overflow: hidden !important; preventing dropdowns from being visible. Changed to overflow: visible !important; to allow proper dropdown display.
  • Z-Index Optimization: Increased dropdown menu z-index from 1031 to 1050 to ensure dropdowns appear above other elements and are properly accessible.
  • JavaScript Structure Cleanup: Removed duplicate initializeBootstrapComponents() code that was causing conflicts and preventing proper Bootstrap initialization.
  • Bootstrap Fallback System: Added robust fallback system for dropdown functionality when Bootstrap fails to load. Manual dropdown toggle with click handlers ensures navigation works even without Bootstrap.
  • Click Outside Handler: Implemented proper click outside handler to close dropdowns when clicking elsewhere, providing standard dropdown behavior.
  • Fortune Wheel Consistency Fixes: Resolved critical Fortune Wheel inconsistency where different values were shown during spin vs after completion. Fixed backend credit logging and frontend display timing.
  • Backend Credit Logging: Fixed bug in ajax/spin_fortune_wheel.php where credits_before and credits_after were identical due to incorrect timing of credit capture. Now captures credits before and after transaction.
  • Frontend Display Timing: Fixed frontend JavaScript in pages/fortune_wheel.php to store prize data in window.pendingWheelResult and only display final result after wheel animation completes, preventing visual discrepancies.
  • Discord Webhook Reliability: Moved Discord webhook call inside main transaction flow in ajax/spin_fortune_wheel.php to ensure notifications are only sent for successful spins.
  • Activity Log Accuracy: Enhanced activity logging to provide accurate credit progression history with correct before/after values for all Fortune Wheel spins.
  • Notification Integration: Added proper notification system integration for Fortune Wheel results with popup notifications after animation completion.
  • Error Handling Improvements: Enhanced error handling throughout navbar and Fortune Wheel systems with comprehensive fallback mechanisms and user-friendly error messages.
  • Mobile Navigation Enhancement: Improved mobile navigation functionality with proper dropdown support and responsive design optimizations.
  • Performance Optimizations: Optimized navbar loading and initialization with immediate fallback system and reduced JavaScript conflicts.
  • Documentation Updates: Updated all documentation to reflect navbar fixes, Fortune Wheel improvements, and enhanced user experience features.
  • Daily Reward Timezone Display: Enhanced daily reward system to show when rewards will be available based on user's local timezone. Users can now see exactly when their next daily reward will reset in their local time.
  • Timezone Configuration: Added configurable server timezone setting for daily rewards with support for Europe/Oslo, Europe/Berlin, and UTC. Server timezone is properly converted to user's local time for display.
  • Real-time Countdown: Implemented live countdown timer showing hours and minutes until next daily reward reset. Countdown updates automatically every minute and displays in user's local timezone.
  • Enhanced User Experience: Daily reward status now shows "Next reward available at [local time] (Xh Ym)" when already claimed, providing clear information about when users can claim again.
  • Profile Navigation Enhancement: Updated navbar dropdown menu to separate "Profile" (user's actual profile page) from "Settings" (profile settings page). Profile link now goes to /users/{id}/profile while Settings goes to /pages/profile.php.
  • URL Routing System: Implemented proper URL routing for user profiles with clean URLs like /users/1/profile. Added URL parsing logic to extract user ID from path and route to correct profile page.
  • Mobile Navigation Updates: Updated mobile navigation to match desktop dropdown structure with Profile and Settings links properly separated and labeled.
  • Card Styling Fixes: Resolved white text on white background issue in community standing cards. All cards now display dark text on white background for proper readability.
  • JavaScript Function Fixes: Fixed "resetDailyRewards is not defined" error by moving function to global scope. Function now available on all tabs, not just community-standing.
  • Codes Loading Fix: Resolved "Cannot read properties of undefined (reading 'forEach')" error in discount codes system. Fixed get_codes.php endpoint to return empty array instead of undefined.
  • Username Search Feature: Added username search functionality to Community Standing page. Admins can now search for users by username and view their standing information with quick action buttons.
  • Norwegian Date Format: Applied Norwegian date format (DD.MM.YYYY) throughout the application including dashboard, bans, profile pages, and daily rewards system.
  • Error Resolution: Fixed all remaining PHP errors including undefined variable warnings, missing table errors, and deprecated function warnings for clean, error-free operation.
  • Database Schema Updates: Added daily_reward_timezone column to settings table to support configurable timezone for daily reward resets.
  • Performance Optimizations: Enhanced daily reward system with proper timezone handling, efficient date calculations, and optimized JavaScript for real-time updates.
  • Documentation Updates: Updated all documentation to reflect new timezone features, navigation changes, and user experience improvements.
  • Complete Session Management System: Implemented comprehensive session management with automatic cleanup, device tracking, and security monitoring. Users can now view all active sessions, device information, and location data with real IP address display.
  • Session Security Features: Added configurable session lifetime (1-365 days), automatic session cleanup with configurable intervals, maximum concurrent sessions per user, and session activity tracking with detailed logs.
  • Enhanced Security UI: Created comprehensive Security tab in user profiles showing active sessions, device information, location data, and recent security events. IP addresses are now prominently displayed instead of showing "Unknown".
  • Geolocation Integration: Implemented IP geolocation using ipapi.com API with fallback handling. Shows city, region, and country information for each session, with graceful fallback to IP address display when location data is unavailable.
  • Session Management Controls: Added individual session logout, bulk session management, and automatic session cleanup with cron job integration. Users can terminate specific sessions or all other sessions for enhanced security.
  • Database Migration Cleanup: Consolidated 20+ scattered migration files into a single comprehensive migration file. Removed redundant migration files and created clean, maintainable database structure with proper documentation.
  • Migration System Overhaul: Created single comprehensive migration file (001_complete_database_setup.sql) that includes all necessary tables, indexes, and default data. Reduced migration files from 20+ to 1, improving maintainability by 95%.
  • Error Resolution: Fixed critical undefined variable errors in navbar.php and missing documentation_tabs table. Resolved all PHP warnings and errors for clean, error-free operation.
  • IP Address Display: Fixed IP address logging and display throughout the system. Real IP addresses (IPv4/IPv6) are now properly captured and displayed in security logs and session management.
  • Activity Logging Enhancement: Updated all activity logging to properly capture IP addresses with IPv4/IPv6 support. Enhanced security event tracking with proper IP address display in user activity logs.
  • Mobile-Friendly Security Interface: All session management and security features are fully responsive with modern UI design. Security information is clearly displayed with proper visual hierarchy and mobile optimization.
  • Performance Optimizations: Added proper database indexes for session queries, implemented efficient cleanup routines, and optimized geolocation API calls with timeout handling and error recovery.
  • Documentation Updates: Updated all documentation to reflect new session management features, migration system changes, and security enhancements. Added comprehensive migration documentation and troubleshooting guides.
  • Wheel of Fortune Enhancements: Major improvements to the Fortune Wheel system with new boost and instant spin features, enhanced user experience, and comprehensive configuration options.
  • Boost System: Added 5-minute boost feature that users can purchase with credits to increase their chances of winning better prizes. Boost multiplies probabilities for top 60% of prizes while reducing chances for lower prizes.
  • Instant Spin Feature: Implemented instant spin option that allows users to skip the wheel animation for faster results. Configurable cost and animation duration with smart timing logic.
  • Toast Notification Fix: Fixed critical timing issue where toast notifications appeared before wheel animation completed. Toast now waits for animation to finish, providing better user experience.
  • Wheel Display Improvements: Enhanced instant spin to properly show the wheel landing on the correct segment. Users can now see exactly which segment they won on, even with instant spins.
  • Configuration Management: All new features are fully configurable from the admin settings panel. Boost cost, duration, multiplier, instant spin cost, and animation duration can all be customized.
  • Database Schema Updates: Added new columns to settings and fortune_wheel_user_stats tables to support boost tracking and instant spin configuration. Includes comprehensive migration script.
  • User Interface Enhancements: Added boost status display with countdown timer, boost purchase button, and instant spin button. All elements are conditionally displayed based on user status and settings.
  • Security & Validation: Enhanced security with proper CSRF protection, role-based access control, and comprehensive input validation for all new features.
  • Mobile-Friendly Design: All new UI elements are fully responsive and optimized for mobile devices with modern styling and intuitive interactions.
  • Performance Optimizations: Reduced default instant spin animation duration from 1000ms to 300ms for truly instant experience. Smart animation logic based on duration settings.
  • Error Handling: Comprehensive error handling and fallback systems for all new features, ensuring robust operation even when components fail.
  • Documentation Updates: Updated all documentation to reflect new features, configuration options, and user interface changes.
  • API Keys Management System: Added comprehensive API keys management page (/pages/api_keys.php) with secure key generation, revocation, and deletion capabilities. Users can create multiple API keys with descriptions, view usage statistics, and manage key permissions.
  • Enhanced Security: Implemented secure API key generation using cryptographically secure random bytes, automatic key expiration tracking, and comprehensive audit logging for all API key operations.
  • API Key Authentication: Enhanced the WebhookService to use API key authentication instead of basic authentication, providing better security and user management capabilities.
  • Mobile-Friendly API Interface: Created a fully responsive API keys management interface with modern design, copy-to-clipboard functionality, and comprehensive documentation.
  • API Documentation Updates: Updated all API documentation to reflect the new API key authentication system and provide clear examples for integration.
  • Database Enhancements: Enhanced the api_keys table with additional security features, usage tracking, and improved indexing for better performance.
  • Rate Limiting Integration: Integrated API key-based rate limiting to prevent abuse and ensure fair usage across all API endpoints.
  • Error Handling Improvements: Enhanced error handling and user feedback for all API key operations with detailed error messages and recovery suggestions.
  • Badge System Implementation: Added comprehensive badge system with role badges and community badges. Role badges (Admin, Moderator, VIP, Premium, Verified, Contributor) are automatically assigned based on user permissions.
  • Badge Display: Badges are prominently displayed on profile pages and in the Community Standing tab. All badges are clickable and link to a dedicated badges page with detailed descriptions.
  • Badges Page: Created a new badges.php page that displays all available badges categorized as role badges or community badges, with visual distinction for earned vs unearned badges.
  • Database Enhancement: Enhanced badges table with role badge flags, role names, and display order. Created migration to update existing badges and assign role badges to users.
  • Mobile-Friendly Design: Badge display is fully responsive with hover effects and modern styling. Role badges use gold styling while community badges use blue styling.
  • Documentation Updates: Added comprehensive badge system documentation including badge types, display features, and FAQ section.
  • Cache Management: Added a comprehensive cache clearing system for browser, session, navigation, and all cache types. Users can now clear cache with one click; session cache clearing logs out all users for security. Robust error handling and user feedback for all cache operations.
  • .htaccess & OpenLiteSpeed/CyberPanel Compatibility: All .htaccess files refactored for full compatibility with OpenLiteSpeed and CyberPanel on AlmaLinux 8.10. Unsupported Apache directives moved to CyberPanel/OLS WebAdmin with clear comments. Security, cache, and compression settings now documented for OLS. Added a checklist for OLS/CyberPanel users in the documentation.
  • Navbar Improvements: Home button now always visible for all users (logged in or not) as the first navigation item. Improved mobile and desktop navigation consistency.
  • Referral System Enhancement: Added comprehensive referral program with social media sharing integration
  • Social Sharing: Integrated Facebook, Twitter, WhatsApp, and Email sharing for referral links
  • Referral Statistics: Real-time tracking of total, completed, and pending referrals
  • Referral Rewards: Automatic credit rewards for successful referrals with configurable amounts
  • Mobile-Friendly UI: Fully responsive referral interface with modern design
  • Auto-Refresh: Automatic stats refresh every 30 seconds when tab is visible
  • Clipboard Integration: One-click referral link copying with fallback support
  • Referral Code Generation: Automatic generation of unique referral codes for users
  • Terms & Conditions: Comprehensive referral program terms and conditions
  • Error Handling: Robust error handling and fallback systems for all referral operations
  • Documentation Updates: Updated documentation with latest features and version history
  • Version Management: Implemented proper 1.x.x versioning system for same-day updates
  • Secure email change flow
  • Plan badge separation
  • UI/UX improvements
  • Bug fixes
  • Privacy Settings: Removed 'Show email address to others' for enhanced privacy.
  • Profile: Added 'Show last seen time' toggle and display, with robust, efficient last seen tracking (session-cached, all activity, auto-updates on login and actions).
  • Roblox Integration: Profile now displays user's primary Roblox group (with caching) if connected via OAuth.
  • Navigation: Added User Management tab in Site Settings for direct access to user management.
  • Navigation: Added Unassigned Pages/Tabs management in Navbar Categories for better organization.
  • Error Handling: Improved error handling and security across all profile and settings pages.
  • UI/UX: All changes are mobile-friendly, visually appealing, and SEO-optimized.
  • Documentation: Updated to reflect all new features and improvements.
  • Fixed all AJAX endpoint paths for settings and codes to use /pages/endpoints/... (absolute path), matching the actual file structure
  • Resolved all 404 errors and ensured all toggles, switches, and settings work instantly with 0% errors or warnings
  • Improved robustness and error handling for all settings tabs
  • Verified and updated all settings/profile tabs for consistent, secure, and mobile-friendly operation
  • Documentation updated to reflect these changes
  • Implemented comprehensive vote system for community engagement
  • Added social network integration to user profiles
  • Enhanced user profile system with social media links
  • Improved email re-verification system for better security
  • Added social media links to profile pages (see example profile)
  • Added user/page search functionality to the navbar for quick navigation
  • Enhanced documentation navigation with improved Table of Contents
  • Added FAQ section to Table of Contents for better accessibility
  • Added Related Pages section to Table of Contents
  • Updated documentation structure for better user experience
  • Improved mobile responsiveness for documentation navigation
  • Enhanced accessibility features for better keyboard navigation
  • Updated version history with current release information
  • Added Wheel of Fortune feature.
  • Implemented daily free spins system with configurable limits (see Wheel of Fortune page).
  • Added paid spin system with cooldown and credit costs (see Wheel of Fortune page).
  • Integrated leaderboard system with weekly rankings (see Wheel of Fortune page).
  • Added GDPR-compliant probability transparency table (see Wheel of Fortune page).
  • Implemented alt account detection and prevention.
  • Added Discord integration for community engagement.
  • Enhanced mobile responsiveness for wheel interface (see Wheel of Fortune page).
  • Added comprehensive admin controls and settings (admin only).
  • Implemented robust error handling and fallback systems.
  • Added User Features page.
  • Added Billing & Credits page.
  • Added Statistics page.
  • Added Announcements page.
  • Enhanced mobile responsiveness and UI improvements
  • Added comprehensive dark mode support for all documentation elements
  • Improved table of contents functionality with better mobile experience
  • Enhanced accessibility features and keyboard navigation
  • Updated Bootstrap to latest version for better performance
  • Added smooth scrolling and improved visual feedback
  • Enhanced error handling and fallback mechanisms
  • Improved documentation structure and readability
  • Added automatic unban synchronization between MAS and Roblox systems
  • Enhanced ban checking to automatically remove Roblox bans when users are unbanned in MAS
  • Added auto-unban sync statistics tracking
  • Added Discord notifications for sync actions
  • Added feature toggle for auto-unban sync
  • Improved error handling for sync operations
  • Updated documentation and examples
  • Added Roblox Ban API integration
  • Added Alt Account Detection support
  • Added feature toggles for individual systems
  • Enhanced ban checking to work with both systems
  • Improved Discord notifications with system information
  • Added comprehensive statistics tracking
  • Updated documentation and examples
  • Complete rewrite with API key authentication
  • Enhanced security and rate limiting
  • Improved error handling and logging
  • Better Discord integration
  • Comprehensive documentation
  • Basic webhook functionality
  • Simple ban checking
  • Limited error handling