Card Reader

A CC:Tweaked peripheral block that reads Create: Numismatics cards. When a player right-clicks the block with a card, it captures the card data and fires a card_scanned event to all attached computers.

Peripheral Type

ptr_utilities:card_reader

Setup

1. Craft a Card Reader (shapeless: any Numismatics card + railway casing + bank terminal)
2. Place it next to a CC:Tweaked computer
3. Wrap it: local reader = peripheral.find("ptr_utilities:card_reader")

The player who places a Card Reader becomes its owner; only the owner (or creative/admin players) can break it or wrench it off.

How Card Scanning Works

A player walks up to the block and right-clicks it while holding a Numismatics card. The block captures the card data in memory (not persisted to disk), creates a short-lived banking session, and fires a card_scanned event.

Card data is lost on chunk unload or server restart.

Events

card_scanned

Fired when a player scans a card at the reader.

local event, data = os.pullEvent("card_scanned")
-- data is a table with:
-- data.type              = "bank" | "authorized" | "id"
-- data.accountID         = UUID string (for bank/authorized cards)
-- data.authorizationID   = UUID string (for authorized cards only)
-- data.playerID          = UUID string (for ID cards only)
-- data.scannedBy         = UUID string of the player who scanned
-- data.scannedByName    = name of the player who scanned
-- data.sessionID         = UUID string of the banking session
-- data.sessionExpiresAt  = unix timestamp when session expires
-- data.terminalID        = UUID string of this card reader terminal

Methods

Card & Session Data

Bank Queries (read-only, no card required)

These query the global Numismatics bank directly. No card scan needed.

Transfer (requires card scan)

Routing depends on the scanned card:

• Plain bank card / ID card → direct deduct/deposit through this mod, only when security.allowUnrestrictedTransfers=true in config/ptr_utilities-server.toml (default false, which rejects with “Transfers require an Authorized Card”).
• Authorized card → Numismatics sub-account flow (authorization type + spend limit enforced by Numismatics).

Transfer receipt format:

{
    transactionID = "uuid",
    operation     = "transfer",
    account       = "from-account-uuid",
    source        = "from-account-uuid",
    destination   = "to-account-uuid",
    amount        = 640,
    timestamp     = 1234567890,
    mac           = "hmac-string"
}

Sessions

When a card is scanned, a session is created:

• Tied to the terminal (not the computer)
• Expires after 60 seconds
• Consumed after a successful transfer
• Cannot be reused once consumed

Check session status via getCardData() — the sessionConsumed and sessionExpiresAt fields tell you if the session is still usable.

Example: Wait for card, then transfer

local reader = peripheral.find("ptr_utilities:card_reader")

print("Waiting for card...")
local event, data = os.pullEvent("card_scanned")

print("Card scanned by " .. data.scannedByName)
print("Account: " .. (data.accountID or "none"))

if data.type == "bank" or data.type == "authorized" then
    local balance = reader.getBalance(data.accountID)
    print("Balance: " .. balance .. " spurs")

    -- Transfer 100 spurs to another account
    local receipt = reader.transfer("destination-account-uuid", 100)
    print("Transfer OK: " .. textutils.serialize(receipt))
end

Coin Denominations