🃏Card Collection
Steps to Add a New Card to the System and to use /collection command.
⚡ First Start
Apply the Database:
Import
collections.sql
into your database.
Install Card Images:
Copy all cards from
html/collections
tovorp_inventory/html/img/items
.
Start the Script:
Launch the script and wait for the automatic card insertion to complete.
Restart the Server:
Restart to update VORP Inventory images and items.
➕ Add a New Card or Collection
1. Define the Card in Config
Edit the configuration file and add your card identifier to the appropriate collection in Config.Cards
.
Each collection supports up to 6 cards.
Example: Adding bt_6
to the "Botilus" collection:
Config.Cards = {
["Botilus"] = {
"bt_1",
"bt_2",
"bt_3",
"bt_4",
"bt_5",
"bt_6" -- New card
},
-- Other collections...
}
2. Add the Card Image
Image size: 150x220 pixels
Format:
.png
Where to place the image:
html/collections
vorp_inventory/html/img/items
(for inventory display)
3. Enable Automatic Database Insertion (Optional)
Set in your config:
Config.AllowAutoInsertInDB = true
4. Test the Card
Restart your server.
Verify that the card is visible in the correct collection and that the inventory displays the image.
📝 Admin Command: /collection
Description
The /collection
command lets authorized admins place cards from any collection in the game world, directly at their current location.
Command Syntax
/collection <collection_name> <card_name>
<collection_name>
: Name of the collection (e.g.,FarWest
,Indian
)<card_name>
: Card identifier within the collection (e.g.,fw_1
,volcae_2
)
Usage
No arguments: Lists all available collection names.
Collection name only: Lists all cards within that collection.
Collection and card name: Places the specified card at your current position.
📦 Card Placement Details
The card’s position (x, y, z) is saved in the database.
After placing, the list of spawned cards is automatically updated for all players.
📌 Notes & Validations
The system checks that the collection and card exist in
Config.Cards
before placement.Prevents duplicate cards at the same location.
The card’s location and details are stored in the database (
collections
table).
📝 Admin Command: /delcollection
Description
The /delcollection
command lets an admin remove a spawned card from the game world if they are standing near it.
How it works
The command checks if the player is an admin.
It detects your character’s current position.
If you are within 5 meters of a placed card, that card will be deleted from:
The world (it disappears for everyone)
The database (permanent removal)
The list of spawned cards is automatically updated and synchronized for all connected players.
Usage
/delcollection
No arguments needed. Simply stand near the card you want to delete and run the command.
📌 Notes
Only admins (as defined in your script’s
checkIfPlayerIsAdmin
) can use this command.The deletion will affect both the server’s memory and the database (collections table).
If you’re not close enough to any card, nothing will be deleted.
Last updated