🔑MLO / Doorlock Purchases

Issuing MLO / Doorlock Access

Access to MLOs or doorlocked locations can be issued to players via Tebex by granting them ownership of a doorlock auth group which they can redeem using /redeem or collect from a configured collection location (depending on your script configuration).

Note: This does not require the customer to enter their CSN during purchase. The player must be online for the deliverable command to execute.

---

Pre-Requisites:

To allow this system to manage MLO and doorlock access, your doorlocks script must expose its authorization groups.

Adding the Required Export

Add the following export to the bottom of your doorlocks script config.lua file:

exports('getAuthGroups', function()
    return Config.AuthGroups
end)

This export allows the script to read and manage doorlock authorization groups correctly.

---

Optional: Transitioning Existing Doorlocked Properties

If you already have properties configured with doorlock access in your doorlocks config.lua and want to fully migrate ownership and access control to this system, follow the steps below.

---

Preparing Existing Properties for Migration

For each existing doorlocked property:

1. Remove any individual player ownership or access entries currently assigned.

2. Add a single placeholder CSN to the property’s auth group.

This placeholder ensures the property remains valid while allowing ownership to be reassigned through Tebex purchases.

Example Auth Group with Placeholder CSN

['franklin_mansion'] = {
    owners = {
        'SJQ71211', -- THIS CAN BE YOUR CSN OR A SIMPLE PLACEHOLDER
    }
},

Why This Is Required: This approach allows ownership to be changed cleanly by relisting the property on Tebex. When a new purchase is claimed:

• The previous owner is automatically removed

• All previous access holders lose access

• The new owner becomes the sole authorized user

---

Restoring Access After Migration

Once you have wiped existing access and moved ownership control to this system:

• Players who previously owned properties will temporarily lose access.

• After your live server restarts, you must issue a manual Tebex transaction for each affected player using:

  /issuetebexpurchase

Once the manual transaction is issued:

• Players can redeem access via /redeem, or

• Collect access from a configured location (depending on your script configuration)

This completes the transition and restores ownership under the new system.

---

Creating the Tebex Package for MLO / Doorlock Access

1. Create a new Tebex package.

2. Add an appropriate title, description, and image.

3. Click Add Deliverable.

4. Select Game Server Commands.

5. Under Game Servers, select your game server.

---

Command Configuration

Under When the package is purchased, enter a variation of the following command:

tebex_addkeys {hexid} franklin_mansion {transaction}

Command Parameters

• {hexid} — Automatically populated by Tebex

• franklin_mansion — The doorlock auth group obtained from your doorlock script config

• {transaction} — Automatically populated by Tebex

---

Additional Settings

• Game Server to Execute On: Select your server

• Require Player to Be Online:

  Only execute the command when the player is online

1. Save and publish the package.

---

Access Delivery

Once purchased and the player is online:

• The player will be able to redeem access via /redeem or by collecting access from a configured location (depending on your script configuration).

• The player will receive an in-game notification confirming this is available for collection / redemption.