Description
FJS Battle Pass Core is a lightweight, modern and fully configurable Battle Pass system for Garry’s Mod servers.
Give your players a reason to keep playing with seasonal progression, daily and weekly missions, free and premium reward tracks, level rewards, leaderboards, admin tools, Discord logs and full SQLite/MySQL support.
Designed for DarkRP and roleplay servers, FJS Battle Pass Core lets you create your own missions and rewards without editing the core code. Whether you want to reward playtime, kills, arrests, job changes, custom addon events or premium VIP perks, the system is built to be flexible, clean and easy to configure.
Why use FJS Battle Pass Core?
Most servers lose players because there is nothing long-term to work toward.
This addon adds a simple but powerful progression loop:
play → complete missions → earn XP → level up → claim rewards
It is perfect for servers that want better player retention, more VIP value, and a more professional gameplay experience.
Main Features
Mission System
Create your own missions directly from the configuration.
Supported mission types include:
Playtime
Player kills
NPC kills
Job changes
Chat commands
Entity spawns
Arrests
Salary received
Custom hooks
Example:
{
id = "daily_playtime",
name = "Active Citizen",
description = "Play for 30 minutes.",
type = "playtime",
goal = 30,
xp = 500,
reset = "daily"
}
You can also connect missions to your own addons using custom hooks.
Reward System
Rewards are fully configurable per level and per track.
Supported reward types include:
DarkRP money
Weapons
Armor
Health
Entities
Console commands
Chat commands
Pointshop points
Custom Lua rewards
Example:
[5] = {
free = {
name = "$10,000",
description = "Receive $10,000 DarkRP money.",
type = "darkrp_money",
amount = 10000
},
premium = {
name = "VIP Bonus",
description = "Receive a premium bonus reward.",
type = "console_command",
command = "ulx adduser {steamid} vip"
}
}
Reward Display Support
Each reward can display a custom visual preview.
Supported display modes:
Icon view
Image view
Model view
Auto view
Example:
display = {
view = "image",
image = "fjs_battlepass/rewards/money.png",
width = 512,
height = 512,
fit = "contain"
}
You can use included icons or add your own images in:
materials/fjs_battlepass/rewards/
Admin Tools
Admins can manage the system directly in-game.
Admin features include:
Give XP
Reset player progress
Reset current season
View players
Open leaderboard
Manage player progression
Commands:
!bp
!battlepass
!bpadmin
Console commands:
fjs_bp_givexp <player> <amount>
fjs_bp_resetplayer <player>
fjs_bp_resetseason
Database Support
FJS Battle Pass Core supports both:
SQLite
MySQL / MySQLOO
SQLite works out of the box.
MySQL can be enabled from the configuration for multi-server setups or persistent production environments.
Discord Webhooks
Optional Discord logging is included.
You can log events such as:
Player reward claims
Admin XP actions
Season resets
Leaderboard/high progression events
Important reward claims
Perfect for staff teams and server owners who want better visibility over progression activity.
Developer API
The addon includes a simple API for developers.
FJS_BP.AddXP(ply, 250, "quest_completed")
FJS_BP.ProgressMission(ply, "daily_playtime", 1)
FJS_BP.ProgressCustomHook("MyAddon_QuestCompleted", ply, 1)
This makes it easy to connect the Battle Pass with custom jobs, quests, delivery systems, mining systems, events, NPCs or any other addon.
Perfect For
DarkRP
PoliceRP
MilitaryRP
SCP-RP
StarWarsRP
Semi-serious RP
Custom RP servers
Why players will like it
Players get clear progression, missions to complete, and rewards to unlock.
Server owners get better retention, more activity, and a clean way to add premium VIP value without forcing gameplay changes.
Requirements
Garry’s Mod server
MySQLOO only required if using MySQL
DarkRP optional but recommended for money/job-related rewards
SQLite works without any external setup.
Included Files
Battle Pass system
Admin panel
Missions system
Rewards system
Leaderboard
Discord webhook support
SQLite/MySQL database support
Reward icons
Documentation
Configuration examples
API examples
Summary
FJS Battle Pass Core is built for server owners who want a clean, configurable and professional progression system without installing a bloated framework.
Set up your season, configure your missions, add your rewards, and give your players something to grind for.
Simple to install. Easy to configure. Powerful enough for serious servers.
