TokyPhone — Documentation
← BACK TO TOKYUBE.COM

TokyPhone

TokyPhone is the in-world handheld every player carries — 25 apps covering identity, marketplaces, media, utilities and mini-games, all inside a phone that slides up from the bottom-right of the screen without ever leaving the world.

Overview

Apps are arranged on a home grid; click (or navigate with a gamepad) to launch. Every app runs inside the phone frame and backs out to the home grid, so your in-world position is never affected.

The 25 apps fall into four buckets:

  • Identity & Social — Messages, Friends, TokyubeSocial.
  • Avatar & Marketplace — Skins, Wigz, Capes, Wearz, Wallet.
  • Media & Utilities — TV Control, Music, Camera, Browser, Notes, Calculator, Calendar, Alarm, Player Stats, TPPV, World Settings, Settings, TokyNodes, Debug.
  • Mini-games — GoPeepGo, Cube Ninja, TokyRoad.

Opening & Navigation

Press P to open or close the TokyPhone — it slides up from the bottom-right. The phone works with keyboard & mouse and with any standard-layout gamepad (Xbox, DualSense, Steam Deck): the engine polls the gamepad every frame, so phone and menu navigation works even before you've clicked into the game canvas.

ActionKeyboard / MouseGamepad
Open / close phonePmapped in the Controller Mapper
Move between appsmouse / arrow keysD-Pad / Left Stick
Launch focused appclick / EnterA / Cross
Back out one screenEscB / Circle
Every binding can be remapped from the Controller Mapper overlay on the title screen. On Steam, the game uses the Generic Gamepad template — your pad shows up as a standard controller, no Steam Input configuration needed.

Universal Controls

Inside any app these behave the same unless the app overrides them:

  • Scroll — mouse wheel or right stick scrolls lists and feeds.
  • Confirm / Cancel — click/Enter confirms; Esc (B/Circle) backs out.
  • Typing — when a text field is focused, all world keys (WASD, jump, mode switching) are captured by the phone so you don't walk while typing.

Messages

Direct-message any Tokyube friend. Threads sync through the Tokyube cloud, so a conversation started in one world continues in the next. Display names prefer your Tokyube @username, falling back to your Steam persona.

Friends

Your friends list, powered by both the Tokyube friend graph and your Steam friends (the engine can pull your Steam friends list and show who's online or in-game). Open a friend to view their profile or jump into Messages.

TokyubeSocial

The full in-engine social network — feed, posts, likes, reactions, comments, polls and profiles — in your pocket. Profiles support up to three clickable links, verified markers, and the Internal badge for Tokyube team members. See the TokySocial documentation for the complete guide.

Skins

Equip any skin you own. The Skins app supports the full skin system:

  • Marketplace skins — One Mesh PBR skins and classic 4-mesh per-part skins from the TokyTar Skins marketplace (free, paid, daily, monthly, animated and UGC Made categories).
  • Custom PBR slots — five slots where you can upload your own albedo / metallic / normal / roughness / emissive maps plus an OBJ or FBX mesh, with auto-fit, PBR toggles and frame animation. Custom skins are stored locally in the browser's IndexedDB.
  • Mesh-swap equip — equipping swaps your avatar's mesh and textures instantly, and syncs to other players over Steam P2P in multiplayer.

Wigz

TokyTar Wigz are baked hair meshes that sit on your avatar's head. The app previews every wig on your own avatar, lets you pick PBR or a custom hair color, and equips instantly. Wigs are persistent, networked in multiplayer, and shown on your title-screen avatar too. New wigs arrive through the Accessories marketplace — including free styles and a rotating daily free wig.

Capes

Equip procedural capes that sway as you move. Capes are persistent and networked — other players see your cape in multiplayer sessions. The Capez marketplace sells textured capes on the shared cape mesh, and creator labels credit every cape's author.

Wearz

Hats and head wearables — bucket hats, fedoras and more — with on-avatar previews and their own shop. Like wigs, wearz are persistent, networked, and previewed on your actual avatar before you buy.

Wallet

Your TTZ balance and transaction history. TTZ (TokyTokinz) is the account-wide currency used across every marketplace — skins, wigz, capes, wearz. The ledger lives in the Tokyube cloud, so your balance follows your account across machines. See TokyTokinz for the full economy guide.

TV Control

Remote-control the video players in the current world: play, pause, seek, volume, and set a new video URL. TVs stream YouTube through the engine's yt-dlp pipeline, and playback syncs to all players in a session. Pairs with the TV, TV Screen and Video Playlist world components.

Music

Your personal soundtrack. Upload up to 25 tracks (stored locally in IndexedDB), then play, pause, skip, shuffle and repeat while you build. Music keeps playing while the phone is closed — and stops automatically when you return to the title screen.

Camera

Capture photos and video clips of your world. Media is saved to your local TokyPhone media library, where you can browse, export to disk, or delete captures.

Browser

A mini web browser inside the phone — type a URL, browse, go back/forward. For a browser panel that lives in the 3D world itself, see the Web Browser components.

Notes

Plain-text scratchpad for build plans, coordinates and ideas. Notes persist with your save data.

Calculator

A standard calculator for quick block math.

Calendar

Monthly calendar grid for keeping track of real-world dates — handy for planning movie nights at the Theater.

Alarm

Set alarms and timers that fire while a world is loaded — never lose track of time mid-build again.

Player Stats

Your player statistics, moved off the world HUD and into their own app — playtime, day/night counts and per-world numbers live here so the in-world HUD stays clean.

TPPV — Tokyube Per-Player Variables

The window into your per-player persistent variables — the cross-world values that scripts read and write with the PPV code blocks. Casino chips, lounge card-game stats and any custom counters a world creator defines are stored per player and follow you between worlds. TPPV lets you inspect the variable groups your account carries.

World Settings

Per-world options for the world you're standing in — including performance settings like the entity cap toggle. Only meaningful in worlds you own or host.

Settings

Player preferences: graphics preset, audio volumes (including People Volume and Microphone Volume for multiplayer voice), mic indicator pills, and controller options.

TokyNodes (in-phone)

Browse your cross-world TokyNode library and spawn saved objects into the current world. Opening a node from this app is also how you enter TokyNode Mode — it's not part of the M mode cycle. Press M afterwards to return to Relaxed. See TokyNodes for the full system.

Debug

Developer helpers: load a character folder onto your avatar, respawn, adjust time of day, and inspect performance/network stats. Debug actions are local-only unless noted.

GoPeepGo

Flap through an endless obstacle course. One tap to flap, instant restart, chase your high score.

Cube Ninja

Slice flying voxel cubes, chain combos, dodge the bombs.

TokyRoad

Hop across roads, rivers and rail lines as far as you can. One more run. Always one more run.