🃏Card Collection

Steps to Add a New Card to the System and to use /collection command.

⚡ First Start

1. Apply the Database:

   • Import collections.sql into your database.

2. Install Card Images:

   • Copy all cards from html/collections to vorp_inventory/html/img/items.

3. Start the Script:

   • Launch the script and wait for the automatic card insertion to complete.

4. 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.