Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
VGSources
Blog

How to Set Up the OpenMod Permission System on Unturned

A complete guide to installing OpenMod.Unturned and managing roles, permission nodes, wildcards, child commands, direct grants, denials, and RocketMod integration.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To set up OpenMod permissions on an Unturned server, install the OpenMod.Unturned module in the server’s Modules directory, start the server once so OpenMod can download its core components, install the plugins you intend to manage, and then configure roles in openmod.roles.yaml. You can also create roles and assign permissions with OpenMod’s om command families. Edits to the roles file take effect immediately; you do not need to reload it.

The important detail is that OpenMod checks complete permission nodes, not just the first part of a command name. A grant for TeleportPlugin:teleport, for example, does not automatically grant TeleportPlugin:teleport.bring. Use help <command> to discover the exact node generated by a command, then grant that node or a deliberate wildcard.

As an Amazon Associate I earn from qualifying purchases.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What OpenMod permissions control

OpenMod describes its permission feature as “a simple role-based permission system.” Roles collect permission nodes, can inherit from parent roles, and can carry a display name, priority, data, and an isAutoAssigned setting. This lets you maintain a small number of reusable access profiles instead of adding every command separately to every player.

A permission node follows the form PluginId:Permission. For instance, a plugin might expose Kr4ken.NewEssentials:commands.home. RocketMod permissions managed through OpenMod use the RocketMod: prefix. The plugin portion and the permission portion must match the node exposed by the plugin; similar-looking text is not enough.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

OpenMod evaluates permissions from roles and from direct user grants. A direct player permission overrides a conflicting role permission, which is useful for a one-player exception but can make later troubleshooting harder if you forget that the direct grant exists.

Install OpenMod.Unturned

1. Download the module

Download the current OpenMod.Unturned module archive from OpenMod’s official installation page. Use the Unturned module rather than a module intended for another game.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. Place the module in Modules

  1. Stop the server if it is running.
  2. Extract the archive.
  3. Copy the extracted OpenMod.Unturned folder directly into the Modules folder inside the Unturned installation directory.

The resulting layout must have the module folder immediately under Modules. Do not leave an extra archive folder in between, such as ModulesOpenMod.UnturnedOpenMod.Unturned.... If the folder is not directly under Modules, the server will not load the module.

3. Start the server and allow first-run downloads

Start Unturned. The first startup can take longer than later starts because OpenMod downloads its core components. Wait for startup to finish before deciding that the installation failed. Once the server is running, install the OpenMod plugins whose commands or features you want to control.

4. Confirm the OpenMod files were created

After the first successful startup, locate the OpenMod directory and look for openmod.roles.yaml. This file is the main place to define or edit roles. If it is missing, first recheck that the OpenMod.Unturned folder is directly under the server’s Modules directory and review the startup output for loading errors.

Choose whether to edit YAML or use commands

There are two supported ways to manage permissions:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
  • YAML configuration: Edit openmod.roles.yaml when you want a repeatable, visible definition of several roles, inheritance relationships, or wildcard and negation rules.
  • Permission commands: Use the om permission and permission-role command families for individual changes while the server is operating.

Changes made to openmod.roles.yaml apply immediately. A reload command is not required, so save the file and then test the affected player or command. Keep a backup before making broad edits, especially when changing inherited roles.

Build roles in openmod.roles.yaml

Minimal role structure

A role entry has an identifier, parent list, permission list, display name, and optional metadata. The following example creates a default role and a moderator role that inherits it:

roles:
- id: default
  parents: []
  permissions:
  - OpenMod.Core:help
  displayName: Default
  data: {}
  isAutoAssigned: true
- id: moderator
  parents:
  - default
  permissions:
  - OpenMod.Core:commands.help
  displayName: Moderator
  priority: 1
  data: {}

The identifiers are the values you use in role commands. displayName is the human-readable label. parents lists roles whose permissions the role inherits. permissions contains the nodes granted directly by that role. data is available for role metadata, and priority can be set when you need to represent an ordering between roles.

Automatic assignment is only for new users

Set isAutoAssigned: true on a role when it should be assigned automatically to new users. This setting does not retroactively add the role to players who already exist. If an existing player needs the role, add it explicitly with om r add player.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep inheritance narrow

Use a parent for permissions that genuinely belong to every child role. For example, put basic help access in default and let moderator inherit it. Avoid creating long chains of parents for one-off grants: every inherited node becomes part of the effective permission set and can make a denial difficult to locate.

When access is not what you expect, inspect the complete chain of parent roles, each role’s permissions, role priorities, explicit negations, and any direct permissions on the player. A direct player permission takes precedence over a conflicting role permission.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Assign and remove roles with commands

Add a role to a player

Use:

om r add player <player> <role>

Replace <player> with the player identifier accepted by your server and <role> with the role ID from the YAML file. For example, if the role ID is moderator, the command ends with moderator, not the display name unless they happen to be identical.

Remove a role

Use:

om r remove player <player> <role>

Removing a role removes the permissions supplied by that membership, but the player may still receive the same node from another role or from a direct permission. If the command still works after removal, inspect those other sources.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add a direct permission

Use:

om p add player <player> <permission>

A direct grant is appropriate for a temporary exception or a single capability that does not justify a new role. Because direct permissions override conflicting role permissions, record why you added one and remove it when the exception ends.

Remove a direct permission

Use:

om p remove <player> <permission>

After removing the direct grant, the player’s effective access may change to the value supplied by their roles. If the permission remains available, check inherited roles and wildcard grants.

Discover the exact permission for a command

OpenMod can generate command permission nodes from the command registration. To identify the node for a command, run:

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
help <command>

Use the permission shown for that command in the role or direct-player grant. This is safer than guessing from the command name because a plugin may use a different permission suffix or a nested command path.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Why a parent command grant may fail

OpenMod treats child commands as separate permission nodes. Granting TeleportPlugin:teleport does not automatically grant TeleportPlugin:teleport.bring or another child node. If a player can run the parent command but receives a permission error for a child, run help for the child and grant its exact node.

Use wildcards deliberately

A wildcard ending in .* covers matching child permissions. For example:

TeleportPlugin:teleport.*

This grants the matching child permissions under teleport. A plugin-wide wildcard such as:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
TeleportPlugin:*

grants all permissions from that plugin. The broader wildcard is convenient for a trusted administrative role but may expose commands you did not intend to delegate. Prefer the narrowest node that satisfies the role’s job.

Explicitly deny an inherited permission

Prefix a permission with ! to forcefully remove an inherited capability:

!Kr4ken.NewEssentials:kits.vip

This is useful when a child role should inherit most of a parent role but must not receive one specific permission. Place the negation in the child role’s permission list and then test the command as a player who has only that role chain. If a direct player grant supplies the same permission, remember that direct user permissions override conflicting role permissions.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

OpenMod and RocketMod together

OpenMod can run alongside RocketMod, but the two systems do not have to share permission decisions. RocketMod must be installed as a separate module for the integration setting to apply. Configure the mode in openmod.unturned.yaml under rocketmodIntegration.permissionSystem.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Mode Permission ownership and behavior Use it when
RocketMod OpenMod uses RocketMod’s permission system. RocketMod is intended to remain the authority for permission checks.
OpenMod RocketMod uses OpenMod’s permission system. You want OpenMod roles and permissions to control RocketMod permission checks.
Separate The systems remain unsynchronized. You deliberately want independent permission sets and understand that a grant in one system will not appear in the other.

Choose the mode based on which system should own the decision. A synchronization mismatch can look like a missing permission: a plugin may be checking RocketMod while you are editing OpenMod roles, or the reverse. After changing the mode, test a command supplied by each relevant plugin rather than assuming all checks use the same backend.

RocketMod permission nodes in OpenMod

When RocketMod permissions are managed through OpenMod, use the RocketMod: prefix in the node. Do not omit that prefix when copying a RocketMod permission into an OpenMod role.

Troubleshoot “I lack permission” errors

The module does not load

  • Confirm the extracted OpenMod.Unturned folder is directly inside the Unturned Modules directory.
  • Start the server again and allow extra time on the first startup for OpenMod’s core-component downloads.
  • Verify that you installed the Unturned module and that the server is loading the same Unturned installation directory you edited.

The role exists but the player has no access

  • Check the role ID in openmod.roles.yaml and compare it with the value used in om r add player <player> <role>.
  • Remember that isAutoAssigned applies to new users only; add the role manually for an existing player.
  • Inspect parent roles and confirm that the permission is actually listed in the effective inheritance chain.
  • Look for an explicit ! negation that removes the node from a child role.
  • Check whether a direct player permission is overriding the role result.

The parent command works but a child command does not

Run help <command> for the failing child command and grant the exact generated node. A parent node does not automatically include child nodes. If several children are intentionally part of the role, use a scoped wildcard such as TeleportPlugin:teleport.* rather than granting the entire plugin with TeleportPlugin:*.

A RocketMod plugin still rejects the player

  • Open openmod.unturned.yaml and inspect rocketmodIntegration.permissionSystem.
  • Confirm whether you selected RocketMod, OpenMod, or Separate intentionally.
  • Ensure RocketMod is installed as a separate module; otherwise these integration settings do not apply.
  • If the mode is Separate, grant the permission in the system that the plugin actually checks.

The node looks correct but is never accepted

A plugin must register its custom permissions before they are checked. OpenMod’s developer documentation describes permission-check results as Default, Grant, or Deny. If the spelling and prefix are correct but the plugin never registered the node, changing the role may not resolve the error; inspect the plugin’s registration and startup behavior.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A safe setup sequence for a live server

  1. Install OpenMod.Unturned directly under Modules and complete one startup.
  2. Install the plugins whose commands you need to govern.
  3. Back up openmod.roles.yaml.
  4. Create a minimal default role and mark it isAutoAssigned: true only if new users should receive it.
  5. Create specialized roles with only the permissions each job requires.
  6. Use help <command> to collect exact nodes, including child-command nodes.
  7. Assign a role with om r add player <player> <role> and test with a real player account.
  8. Add direct permissions only for documented exceptions.
  9. If a capability must be excluded from an inherited role, add an explicit ! negation and test again.
  10. If RocketMod is installed, set and verify the integration mode before diagnosing individual plugin permissions.

This sequence keeps the permission source visible: common access comes from roles, exceptions are identifiable as direct grants, and command failures can be traced to the exact node rather than to a guessed parent permission.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.