Player Actions

Player actions are the things you can do in Citizen of Arcanis. Each action is handled by smart contracts to ensure fairness and permanence.

What Are Actions?

Simple Explanation

Actions are like buttons you click in the game. When you click "Attack" or "Trade Item", the game sends a message to the blockchain smart contracts to make it happen.

Why Use Smart Contracts for Actions?

  • Fair play: Everyone follows the same rules

  • No cheating: Actions can't be faked or manipulated

  • Permanent results: Your actions have lasting consequences

  • True ownership: Items and progress belong to you

Core Action Systems

Player Management Actions

Create Character

  • Choose your faction (permanent decision)

  • Set initial stats and appearance

  • Register your character on the blockchain

Level Up

  • Spend experience points to increase stats

  • Unlock new abilities and equipment slots

  • Permanent character progression

Faction Actions

  • Participate in faction events

  • Contribute to faction goals

  • Earn faction-specific rewards

Combat Actions

Attack Enemy How it works:

  1. You select an enemy to attack

  2. Smart contract checks if you're in range

  3. Contract calculates damage based on your stats and equipment

  4. Enemy's health is reduced

  5. You gain experience points

  6. Possible item drops are awarded

Use Special Ability

  • Faction-specific combat skills

  • Consumes energy or resources

  • Enhanced damage or special effects

Heal/Rest

  • Restore health points

  • May require items or safe locations

  • Time-based or resource-based recovery

Equipment Actions

Equip Item Process:

  1. You select an item from your inventory

  2. Contract checks if you meet requirements

  3. Contract verifies you have empty equipment slots

  4. Item is moved to appropriate body slot

  5. Your stats are updated with item bonuses

Unequip Item

  • Remove items from equipment slots

  • Return items to inventory

  • Stats return to base values

Upgrade Equipment

  • Use materials to improve items

  • Increase item stats and rarity

  • Permanent improvements stored on blockchain

Trading Actions

List Item for Sale Steps:

  1. You select an item and set a price

  2. Contract verifies you own the item

  3. Item is locked (can't be used while listed)

  4. Marketplace listing is created

  5. Other players can see and buy it

Purchase Item Process:

  1. You select an item from marketplace

  2. Contract checks if you have enough currency

  3. Payment is transferred to seller

  4. Item ownership is transferred to you

  5. Item appears in your inventory

Direct Trade

  • Trade items directly with another player

  • Both players must agree to the trade

  • Secure exchange handled by smart contracts

Marketplace Actions

Browse Items

  • View all items available for sale

  • Filter by type, rarity, faction, price

  • Real-time marketplace data

Price Discovery

  • See historical sale prices

  • Compare similar items

  • Make informed trading decisions

Auction Participation

  • Bid on rare items

  • Time-limited competitive pricing

  • Automatic highest bidder wins

How Actions Are Processed

Transaction Flow

  1. You perform an action in the game interface

  2. Transaction is created with your action details

  3. Sent to Starknet blockchain for processing

  4. Smart contract validates the action is legal

  5. Contract executes the action and updates game state

  6. Results are confirmed on the blockchain

  7. Game interface updates to show the results

Validation Checks

Before any action is executed, smart contracts verify:

  • Identity: Are you who you claim to be?

  • Ownership: Do you own the items you're trying to use?

  • Resources: Do you have enough health/energy/currency?

  • Rules: Does the action follow game rules?

  • Timing: Are you allowed to perform this action now?

Gas Fees

What Are Gas Fees? Small amounts of cryptocurrency paid to process your actions on the blockchain.

In Citizen of Arcanis:

  • Fees are very low on Starknet

  • Simple actions cost pennies

  • Complex actions cost slightly more

  • No monthly subscription fees

Action Categories

Free Actions

Some actions don't cost gas fees:

  • Viewing your character stats

  • Browsing the marketplace

  • Reading game information

  • Planning your strategy

Actions that change the blockchain state require gas:

  • Combat and fighting

  • Trading and marketplace activities

  • Equipment changes

  • Character progression

Batch Actions

You can combine multiple actions to save on fees:

  • Equip multiple items at once

  • Buy several marketplace items together

  • Process multiple trades simultaneously

For Players

Getting Started

  1. Connect your wallet (like Argent or Braavos)

  2. Get some ETH for gas fees (very small amounts)

  3. Create your character and choose faction

  4. Start playing - each action is automatically processed

Tips for Efficient Play

  • Plan your actions: Batch similar actions together

  • Check gas fees: Perform actions when network is less busy

  • Understand costs: Know which actions require fees

  • Be patient: Blockchain transactions take a few seconds

What Happens When You Act

Every action you take:

  • Is permanently recorded on the blockchain

  • Can be verified by anyone

  • Contributes to the game's permanent history

  • Affects the global game state

  • Earns you true ownership of results

The smart contract system ensures that your achievements in Citizen of Arcanis are permanent, verifiable, and truly yours.

Last updated