FoxDev-Magazine
An interactive magazine system for FiveM servers using the QB-Core/Qbox framework. Create, edit, and read digital magazines in-game with a modern and intuitive interface. Support for multiple editions and player-specific magazine ownership.
Features
-
Interactive Reading Experience
- Smooth page-turning animations
- Zoom functionality for detailed viewing
- Keyboard and mouse navigation
- Fade-in animations
-
Magazine Editor
- Multiple edition support
- Add/remove pages per edition
- Reorder pages via drag-and-drop
- Image URL support
- Real-time preview
- Edition publishing system
-
Player Magazine System
- Player-specific magazine ownership
- Edition tracking
- Purchase history
- OX Inventory integration
-
Database Integration
- Multiple edition support
- Automatic page ordering
- Player ownership tracking
- Edition status management
Requirements
- QB-Core Framework
- ox_inventory
- qb_inventory
- QBox
Installation
-
Download & Place Files
cd resources git clone https://github.com/yourusername/qb-magazine -
Database Setup
The resource uses three main tables:magazine_editions: Stores different magazine editionsmagazine_pages: Stores pages for each edition
Import the SQL file from
sql/magazine.sqlwhich will create all necessary tables and indexes. -
Add to Server.cfg
ensure FoxDev-magazine -
OX Inventory Setup
Add to yourox_inventory/data/items.lua:['magazine'] = { label = 'Magazine', weight = 500, stack = false, close = false, description = 'A readable magazine', consume = 0, client = { export = 'fd-magazine.useMagazine' } }
Configuration
Edit config.lua to customize:
Config = {}
-- Jobs that can access the editor
Config.AuthorizedJobs = {
['news'] = true,
['admin'] = true
}
-- Item name in QB-Core shared items
Config.MagazineItem = 'magazine'
-- Image Settings
Config.MaxImageSize = 5 * 1024 * 1024 -- 5MB
Config.AllowedImageTypes = {
'jpg',
'jpeg',
'png',
'gif'
}
Commands
/magazine- Open owned magazine editions/magazineeditor- Open editor (authorized jobs only)/createedition [title]- Create new edition/publishedition [number]- Publish an edition
Usage
Reading a Magazine
- Purchase or receive a magazine edition
- Use the magazine item from inventory
- Navigate using:
- Arrow keys (← →)
- Mouse clicks on page corners
- Navigation buttons
- Press ESC to close
Editing a Magazine
- Select or create an edition
- Add pages via URL input
- Drag & drop to reorder
- Save changes
- Publish when ready
Image Guidelines
- Recommended Format: JPG/PNG
- Optimal Resolution: 1920x1080
- Maximum File Size: 5MB
- Aspect Ratio: 16:9 (recommended)
Troubleshooting
-
Images Not Loading
- Verify URL is accessible
- Check image format
- Ensure URL is HTTPS
-
Editor Not Opening
- Verify job permissions
- Check server console for errors
-
Database Issues
- Verify oxmysql is running
- Check table relationships
- Verify edition exists before adding pages
-
Edition Access Issues
- Check if edition is published
- Verify player ownership
- Check edition status (active/inactive)
Development
Database Structure
magazine_editions
- id (AUTO_INCREMENT)
- edition_number (UNIQUE)
- title
- is_active
- is_published
- created_at
magazine_pages
- id (AUTO_INCREMENT)
- page_number
- image_url
- edition_number (FK)
- created_at
File Structure
qb-magazine/
├── client/
│ └── main.lua
├── server/
│ └── main.lua
├── html/
│ ├── index.html
│ ├── style.css
│ └── script.js
├── sql/
│ └── magazine.sql
├── config.lua
└── fxmanifest.lua
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
- Discord: [FoxDev]
Credits
- FoxDev
Updates
Check CHANGELOG.md for version history and updates.
Made with 
for the FiveM Community
|-------------------------------------|----------------------------|
| Subscription-based | No |
| Support | Yes |
