Settings Overview
The Settings page is the central configuration hub for your HandyCafe server. All operational parameters for your internet cafe or gaming center are managed here, including pricing, network configuration, client appearance, and authentication.
Accessing Settings
Open the Settings page from the main navigation sidebar. The page displays a category list on the left and the active category's configuration panel on the right.
Settings Categories
The settings sidebar groups configuration into the following categories:
| Category | Description |
|---|---|
| General | Country, language, font, currency, and calendar preferences |
| Pricing | Hourly rates, fees, VAT, rounding, and session presets |
| Pricing Plans | Fixed-duration pricing plans and pricing groups |
| Pricing Schedule | Time-based pricing multipliers with a visual weekly grid |
| Network | TCP, UDP, and file transfer port configuration plus connection key |
| Sounds | Notification sounds for cashier calls, orders, and session events |
| Management | Customize the management action menu items and layout |
| Printers | Printer inventory and role assignment for bills, kitchen, and ticket receipts |
| Cafeteria | Enable the cafeteria module and configure business details |
| OAuth | OAuth provider configuration for device-flow member login |
| Clients | Client device settings with four sub-tabs: General, Content/Menu, Appearance, and Idle Screen |
| Staff | Manage cashier accounts and their assigned roles |
| Security | Anti-cheat tamper monitoring, HWID blacklist, and client hardening |
| Options | System toggles for autorun, post-paid sessions, and double-click start and stop |
| Legacy Clients | Runtime protocol listeners and optional database migration for V3 and V4 client installations |
| Sync Explorer | File synchronization to push updates and files to client PCs |
| Database Maintenance | Backup, vacuum, integrity checks, and scheduled maintenance |
Saving and Canceling Changes
Global Save and Cancel buttons are displayed at the bottom of every settings panel.
- Change detection -- The Save button is only enabled when you have made modifications to the current category. If no changes are detected, the button remains disabled.
- Cancel -- Reverts all unsaved changes in the current category back to the last saved state.
- Validation feedback -- If any field contains an invalid value (for example, a port number outside the allowed range), the Save button is disabled and the problematic field is highlighted with an error message.
- Notification on save -- After a successful save, a confirmation notification appears briefly at the top of the panel. If the save fails (for example, due to a database write error), an error notification is shown instead.
Tips
- Changes to network settings (ports and connection key) require a server restart and corresponding updates on every client device.
- Pricing and schedule changes take effect for new sessions immediately; active sessions continue under the pricing terms that were in place when they started, with new pricing segments created at schedule slot boundaries.
- Client appearance and menu changes are pushed to all connected clients in real time. No manual sync is required.