📪 Mailbox - with couriers and delivery

Make buying things from the store an interesting part of the gameplay!

This system corrects the unrealistic purchase of items in DarkRP. Items arrive in the mail, not in the air in front of you. Each item can have its own delivery time. You can pick up the parcel either by yourself or through a courier order. In any case the goods weigh something, either you pay with your time and carry everything on your back, or with money to the courier.

This addon also:

• Adds a new courier job with a unique and realistic gameplay. Couriers deliver orders to citizens using a delivery system. This is a new and interesting way to make money. Do you have the strength to carry a huge box to the customer?
• Adds more interaction between players
• Adds the ability to buy home mailboxes attached to doors
• Forces players to move around the map, rather than sitting in one place somewhere underground
• Adds more realism and RP situations to your server

More in "✨ Features" tab!

How it works?

1. A person buys an item. If the item is added to the system, a notification appears about the time before arrival in the mailbox

2. If there are couriers on the server and they are free, the person is asked to order delivery

3. If a person orders delivery, he chooses items that need to be delivered. The more items, the heavier the box will be and the greater the cost. Delivery is optional, you can drag the box yourself

4. The delivery request is sent to all available couriers. The first courier who accepted the order goes to the mailbox, picks up and delivers the parcel, after which he receives money

• Easy installation, translation and configuration (Check "📥 Installation" and "🔧 Config" tabs)
• Easy installation of certain items that will be purchased via Mailbox
• Ability to set all categories for mailbox: Food, Weapons, Shipments, Ammo, Entity
• The ability to set the delivery time for both categories and individual items
• "Courier" job
• Custom SWEP for Couriers
• A weight system that affects the speed of movement. The more items you drag, the slower you are
• Ability to put money directly to a person's home mailbox
• Ability to receive salary in mailbox
• Shipment entity, that contains items from Mailbox. By pressing "E" items drop out one by one. Gravgun pickup and using this entity allowed only for owner
• Complete delivery system: markers, timers and more
• Adjusting entity limits

// All times in SECONDS


dn_Mailbox.cfg.Language = 'english' // english, french, polish, german, russian


dn_Mailbox.cfg.CourierJob = 'Courier'


/*
	If an item from this category is not in the ItemsTiming table, 
	it will be delivered within the time specified by its category
*/
dn_Mailbox.cfg.CatsTimings = {
	['entity'] = 60,
	['food'] = 20,
	['weapon'] = 10,
	['shipment'] = 60,
	['ammo'] = 5,
}


/* Delivery time of certain items, overlaps the time of categories */
dn_Mailbox.cfg.ItemsTimings = {
	['ls_sniper'] = 1020,
}


/*
	Disabled categories - items from them will spawn in front of your face. 
	To disable the category, set it to true.
*/
dn_Mailbox.cfg.DisabledCats = {
	['entity'] = false,
	['food'] = false,
	['weapon'] = false,
	['shipment'] = false,
	['ammo'] = false,
}


/* Disabled items, that doesn't arrive through mailbox */
dn_Mailbox.cfg.Blacklist = {
	['money_printer'] = true,
}


/* max amount of questions on screen */
dn_Mailbox.cfg.maxQuestions = 3


/* time for the courier to pick up the shipment from mailbox */
dn_Mailbox.cfg.TimeToTake = 60
/* time for the courier to deliver the shipment to the customer */
dn_Mailbox.cfg.TimeToDelivery = 60*10


/* price for 1 item delivery */
dn_Mailbox.cfg.PricePerItem = 125 -- 125$ for 1 item delivery


/* 
	1 item will take away the (default movement speed - movement speed * 0.05)


	Warning: If you do not understand how to calculate it, it is better not to touch it (or contact me)
*/
dn_Mailbox.cfg.ItemPercentSpeed = 0.05 // Default movement speed * 0.05 = ~14 ==== ~13 items


/* 
	The limit of the courier's minimum movement speed. 
	The courier will not be able to take the number of items at which 
	his movement speed will be lower than this percentage of the normal speed


	Warning: If you do not understand how to calculate it, it is better not to touch it (or contact me)
*/
dn_Mailbox.cfg.MinPercentSpeed = 0.4 // Speed not less than 40%


/* send payday money to mailbox */
dn_Mailbox.cfg.PaydayToMailbox = true

Installing of addon

1. Install TDLib (*click me*)

2. Unpack ZIP archive to your addons folder

3. Add Steam Workshop Item to server collection (*click me*)

Setting the public Mailbox positions

Only superadmins can do it and there is no limit for Mailbox entities.

1. Spawn and place Mailbox from Entities > Mailbox > Mailbox

2. After you have placed all the necessary Mailboxes, go to Q menu > Options > Mailbox and press "Save mailbox(-es)" button

If you want to delete placed entities use "Remove mailbox(-es)" button in Q menu > Options > Mailbox

Setting the home Mailbox positions

Only superadmins can do it and there is no limit for home Mailbox entities. But rule is 1 door = 1 mailbox.

1. Select "Mailbox placer" in Q menu > Tools > Mailbox

2. Press RMB on wall to spawn home mailbox entity

3. Press LMB on door to select it

4. Press LMB (when door is selected) on placed home mailbox entity to link them and make the pair

After creating a pair, it is automatically saved

Don't delete other home mailbox entities until you have arranged all the necessary ones

If you made a mistake - use R on door to delete pair

Adding another language / translation

To add new language create copy of english.lua with another name (for example danish.lua) in dn_mailbox\lua\mailbox\languages and write your own translation. Don't forget to change it in config to your filename (for example danish)

If you have any problems with the addon, you can open the ticket and explain it. Please be specific in your ticket and attach the error log (if any). Thanks!