About CustomMedical
-
CustomMedical
- Take control of how medical items work on your server!
- CustomMedical lets you turn syringes, bandages item into fully customized healing kits — with configurable boosts, usage limits, permissions, timed effects, commands, and even loot drops.
-
Perfect for RPG-style servers, PvE heal systems, and VIP reward kits.
-
Features
- Unlimited customization: Rename syringes/bandages, give them custom skins, and show [Uses:X] right on the item.
- Usage limits: Configure how many times each item can be used before it’s consumed.
- Boost system: Add health, hydration, calories, comfort, or radiation effects — with optional timers and automatic reset.
- Status UI integration: Show a live “Medical Time” bar via SimpleStatus (optional dependency).
- Timed permissions: Grant temporary permissions or groups on use with TemporaryPermissions (optional dependency).
- Commands on use: Run one or multiple chat/console commands when the item is used.
- Loot integration: Configure loot crates, heli crates, and Bradley crates to spawn your custom items at custom rates.
- Anti-stack protection: Prevents players from stacking custom medical items (no “dupe” exploits).
-
Prefix & color customization: Fully configurable chat prefix with color tags.
-
Commands
-
/givesyringe <id|name> [amount] → Give yourself a configured medical item. /givesyringe <player> <id|name> [amount] → Give a configured item to another player. (Also available as console command givesyringe.)
-
Example Configuration
-
Quote
{
"Plugin Settings": {
"Chat Prefix": "[Custom Medical]",
"Prefix Color": "#00FF00"
},
"Medical Items Settings": {
"Item List": {
"3550559547": {
"Item Name": "Food Syringe",
"Permission (Empty = not need)": "",
"Basic Item (shortname)": "syringe.medical",
"Disable the item original healing": true,
"Item will not be consumed": false,
"Number of use (0 = Disable)": 3,
"Enable Medical Time": true,
"Medical Time Seconds": 60.0,
"Boost Settings": {
"Enable Boost": true,
"Max Health": 0.0,
"Max Health Duration (0=Until Medical Time)": 60.0,
"Add Health": 10,
"Health Duration (0=Until Medical Time)": 0.0,
"Add Health Over Time": 30,
"Health Over Time Duration (0=Until Medical Time)": 0.0,
"Add Hydration": 100,
"Hydration Duration (0=Until Medical Time)": 0.0,
"Add Calories": 200,
"Calories Duration (0=Until Medical Time)": 0.0,
"Add Radiation": 0,
"Radiation Duration (0=Until Medical Time)": 0.0,
"Add Bleeding": 0,
"Bleeding Duration (0=Until Medical Time)": 0.0,
"Add Comfort": 0,
"Comfort Duration (0=Until Medical Time)": 0.0,
"Reset Radiation": false,
"Reset Bleed": false,
"Reset Comfort": false,
"Target Hydration Max (0=Ignore)": 0.0,
"Target Calories Max (0=Ignore)": 0.0,
"Target Comfort Max (0=Ignore)": 0.0
},
"Command Settings": {
"Enable Command": false,
"Server run command (false = PlayerClient)": true,
"Run all command (false = Random one)": false,
"Command List": [
"o.grant user %STEAMID% vip.vip",
"say hi, %PLAYERNAME%"
]
},
"Temporary Permission On Use": {
"Enabled": false,
"PermissionOrGroup": "",
"IsGroup": false,
"Seconds": 120,
"FromNow": true
},
"Tips Message (Empty = no message)": "",
"Tips Message Chat Prefix": true,
"Effect (Empty = no effect)": "",
"Status Settings": {
"Enable Simple Status": true,
"Simple Status Title": "Food Boost",
"Background Color": "0.15 0.85 0.65 0.85",
"Title Color": "1 1 1 1",
"Text Color": "1 1 1 1",
"Icon": ""
},
"Drop Settings": [
{
"Enabled": true,
"Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab",
"Chance": 8,
"Min Amount": 1,
"Max Amount": 2
},
{
"Enabled": true,
"Prefab": "assets/prefabs/npc/patrol helicopter/heli_crate.prefab",
"Chance": 10,
"Min Amount": 1,
"Max Amount": 2
},
{
"Enabled": true,
"Prefab": "assets/bundled/prefabs/radtown/crate_elite.prefab",
"Chance": 5,
"Min Amount": 1,
"Max Amount": 2
},
{
"Enabled": true,
"Prefab": "assets/prefabs/npc/m2bradley/bradley_crate.prefab",
"Chance": 10,
"Min Amount": 1,
"Max Amount": 2
}
]
},
"3551177681": {
"Item Name": "Instant Syringe",
"Permission (Empty = not need)": "",
"Basic Item (shortname)": "syringe.medical",
"Disable the item original healing": true,
"Item will not be consumed": false,
"Number of use (0 = Disable)": 2,
"Enable Medical Time": true,
"Medical Time Seconds": 60.0,
"Boost Settings": {
"Enable Boost": true,
"Max Health": 100.0,
"Max Health Duration (0=Until Medical Time)": 0.0,
"Add Health": 80,
"Health Duration (0=Until Medical Time)": 0.0,
"Add Health Over Time": 0,
"Health Over Time Duration (0=Until Medical Time)": 0.0,
"Add Hydration": 0,
"Hydration Duration (0=Until Medical Time)": 0.0,
"Add Calories": 0,
"Calories Duration (0=Until Medical Time)": 0.0,
"Add Radiation": 0,
"Radiation Duration (0=Until Medical Time)": 0.0,
"Add Bleeding": 0,
"Bleeding Duration (0=Until Medical Time)": 0.0,
"Add Comfort": 0,
"Comfort Duration (0=Until Medical Time)": 0.0,
"Reset Radiation": true,
"Reset Bleed": true,
"Reset Comfort": false,
"Target Hydration Max (0=Ignore)": 0.0,
"Target Calories Max (0=Ignore)": 0.0,
"Target Comfort Max (0=Ignore)": 0.0
},
"Command Settings": {
"Enable Command": false,
"Server run command (false = PlayerClient)": true,
"Run all command (false = Random one)": false,
"Command List": [
"o.grant user %STEAMID% vip.vip",
"say hi, %PLAYERNAME%"
]
},
"Temporary Permission On Use": {
"Enabled": false,
"PermissionOrGroup": "",
"IsGroup": false,
"Seconds": 120,
"FromNow": true
},
"Tips Message (Empty = no message)": "",
"Tips Message Chat Prefix": true,
"Effect (Empty = no effect)": "",
"Status Settings": {
"Enable Simple Status": true,
"Simple Status Title": "Instant Boost",
"Background Color": "0.15 0.85 0.65 0.85",
"Title Color": "1 1 1 1",
"Text Color": "1 1 1 1",
"Icon": ""
},
"Drop Settings": []
}
}
},
"Config Version": {
"Major": 1,
"Minor": 0,
"Patch": 1
}
} -
Permissions
-
custommedical.admin → Allows use of /givesyringe and console give commands. You can define per-item permissions in the config (e.g., custommedical.vipheal), then grant them with oxide.grant user <name> custommedical.vipheal.
-
Why Choose CustomMedical?
- Because sometimes vanilla healing just isn’t enough.
- This plugin gives you full control — from simple rebalanced syringes to complex RPG-style healing kits with timed buffs, effects, and rewards.
