Citizen

Citizen #1

A Neo Tokyo Citizen is the NFT created by staking the three components (and optional Vault) in the Citizen Contract. While the component pieces of a citizen are shown as text with computer code syntax, the Citizen NFT is an image of a character based on the properties described in the text of the component parts.

A Citizen is distinct NFT from an Outer Citizen.

Properties

The properties of the Citizen NFT are derived from its component Identity, optional Vault Card, Item Cache, and Land.

Creating a Citizen

Creating a Citizen requires:

• An Identity or a Bought Identity
• Item Cache
• Land Deed NFT

An optional Vault can be used to increase the $BYTE yield of the resulting Citizen.

Citizen Assembler

To review how available Neo Tokyo components would fit together, prior to assembly, try the Citizen Assembler.

The Citizen Assembler at, https://neotokyo.codes/assembler, offers a simple way to preview a Citizen's appearance and their resulting rarity score, ranking, and yield by selecting the preferred Identity, Vault, Item Cache, and Land Deed #'s.

The Citizen Assembler at https://neotokyo.codes/assembler

Appearance

A citizen's appearance depends on the characteristics described in the Identity and the Item Cache and their gender. The background of the resulting composite is based on the Land Deed.

• 

  Citizen 18

• 

  Citizen 218

• 

  Citizen 10

• 

  Citizen 4

• 

  Citizen 548

• 

  Citizen 1485

• 

  Citizen 2368

• 

  Citizen 2497

Profile Picture

To get a PNG image of your Citizen, ideal for a profile picture -- instead of the individual SVG layers -- use Ryan's citgen site at:
https://citgen.rcw.io/s1/1200x1200/1666
...where 1666 is your Citizen number.

The URL can be modified to:

• Change the size of the image... https://citgen.rcw.io/s1/486x486/1666
• See the female version of the Citizen (S1s only)... https://citgen.rcw.io/s1/1200x1200/1666?female=true
• Turn off the background... https://citgen.rcw.io/s1/1200x1200/1666?no-bg=true
• Or, all three at the same time... https://citgen.rcw.io/s1/486x486/1666?female=true&no-bg=true

Rarity

A rarity score is given to each Citizen based on the combined score of its constituent NFTs. A Citizen with a top 500 rarity score is considered Elite and has access to the Metaverse Lounge channel in the Neo Tokyo Discord.

Citizen rarity scores are listed at https://neotokyo.codes/trade

For more information refer to the Rarity article.

Benefits of Citizenship

• Uploading component NFTs to the Citizen contract creates the Citizen profile picture.
• Uploaded Citizens produce credits/$BYTES.
• Citizens can access exclusive Discord channels
• Citizens can create teams and join guilds
• Create a unique on-chain description for a Citizen at upload

Teams and Guilds

Guilds were created as a means of distributing Chips prior to the Meta Tournament. There are 10 guilds and each guild is comprised of (up to) 200 Citizens. Guilds manage Citizens and Citizens manage their respective teams. A team is comprised of one Citizen manager and two Outer Citizen players.

How to Upload a Citizen

The process of creating a Citizen requires the necessary component NFTs to be staked in the Citizen contract. This process is also known as Uploading.

To upload a Citizen:

1. Connect a wallet with the required NFTs to the Upload page of https://neotokyo.codes
2. Select the component NFTs to combine for the citizen through the website's interface
3. Write a custom description (upload message)
4. Press Upload
5. Confirm a transaction for each NFT that will be uploaded and a final upload transaction

This will require wallet confirmation and significant gas fee because of the amount of data in the transaction.

To upload via contract, see Uploading a Citizen Through the Contract.

Citizenship Number

• A new Citizenship number is provided with each uploaded Citizen, adding +1 to the number of the last uploaded Citizen.
• Numbers are consecutive, based on upload, and are automatically assigned.
• Numbers will not be reused when a citizen is disassembled and reassembled.

Unstake and Disassemble a Citizen

To swap out or trade a component NFT, the Citizen must be disassembled. This process returns the component pieces and the Citizen number is destroyed. The Citizen will no longer produce $BYTES, but all accumulated unclaimed $BYTES will still be available.

Before disassembling, claim your $BYTES (instructions here).

To disassemble, connect the wallet containing the Citizen to the Citizen Contract address

Enter the Citizen's ID in the 5. disassembleCitizen function of the contract and Write.

$BYTES

Each Citizen produces $BYTES tokens based on its component Identity's credit yield value and, if it was uploaded with a Vault, the Vault modifier. Outer Citizens do not yield $BYTES.

To determine a Citizen's $BYTE yield, information on claiming $BYTES, determining the amount that a Citizen has produced, or minting additional NFTs with $BYTES, refer to the Bytes article.

For more information on claiming $Bytes from an unopened vault, refer to Neo Tokyo Part 2 Vault Card (NEOTV).

Contract Address

https://etherscan.io/address/0xb668beb1fa440f6cf2da0399f8c28cab993bdd65

Marketplace Collections

https://opensea.io/collection/neotokyo-citizens
https://byt.io/ethereum/collection/neotokyo-citizens