Skip to content

README.md

Latest commit

 

History

History
170 lines (117 loc) · 6.23 KB

README.md

File metadata and controls

170 lines (117 loc) · 6.23 KB
Raw

CKEY: CTRL+N

Fast-paced, skill-based mobile action game with hand-crafted pixel art - developed with a passion for indie games and code itself [🐍]. Tap to dodge, swipe to [TBA], compete against your fellow degens, unlock new characters (keys), flex your rank roles in the community, try different audio packs (coming soon), and have fun!

Built with Python 3.12 + Godot 4.6 | Web3-ready with optional Solana + Bitcoin ordinal (coming soon) profiles | Energy-based free-to-play | Powered by Solana + Bitcoin + Matrica

Godot Python Status Platform Solana Bitcoin License

🚀 Download v0.1.1 Demo

Playable Android demo with Matrica login. Latest release →

Note: Only the black player key is fully animated in this build. You can play as the 3 other base keys (dark_green, blue, red), but they won't have full in-game animations yet.

🚧 Early-Stage Development

This project is actively under development and not yet available in app stores. All releases (including demos) are maintained on the GitHub Releases page. Security note: v1 endpoints were deprecated at public release. Legacy integration points have been disabled—please refer to current documentation for v2 setup.

Licensed under GPL-3.0 + Commons Clause. Permitted uses:

  • ✅ Personal play & testing
  • ✅ Educational projects & portfolios
  • ✅ Contributing improvements to this repository
  • ❌ Commercial use or selling derivatives

See LICENSE for full terms.

Quick Links

Getting Started

Try the Demo (Easiest)

Download the latest release from the Releases page and install ctrln.apk on Android 8+.

Build from Source (Developers)

Prerequisites:

  • Godot 4.6.1.stable
  • Android SDK for mobile builds
  • Python 3.12+ (optional, for desktop testing)
  • Optional: Phantom or Solflare wallet app for testing Solana authentication

Build Steps:

cd godot
./build-release.sh

Output: ctrln.apk (Android)

Features

Gameplay

  • One-button tap mechanics with deep skill ceiling
  • Procedurally challenging obstacle escalation
  • Real-time global leaderboards
  • Unlock characters and achievements

Monetization

  • Energy System: 5 free matches per session/day (TBD) — demo is open play
  • $SKR Store: In-game cosmetics, playtime (energy), action-item purchases
  • Optional NFT: Mint profile as NFT portability, permanence, and bonuses

Web3 Integration

  • Matrica OAuth (primary): Multi-chain social login
    • includes all major web3 wallets (including native solana mobile wallet)
    • includes social login via discord, x, and tg
  • Solana Wallet Adapter (secondary, coming soon): Direct wallet signing via Mobile Wallet Adapter
  • Cross-Chain Assets: Unlock bonuses by validating Bitcoin/Ethereum NFTs via Matrica (coming soon)
  • Discord: Rank-based roles verified via multi-chain asset verification (coming soon)

Project Structure

CtrlN/
├── godot/                 # Game project (Godot 4.6)
│   ├── scenes/            # .tscn scene files
│   ├── scripts/           # GDScript gameplay logic
│   │   └── autoload/      # Singletons (MatricaAuth, SolanaAuth)
│   └── addons/            # Plugins (SolanaSDK GDExtension)
├── src/                   # Python desktop version (Pygame)
├── player_data/           # Sample player profiles (Pygame)
└── docs/                  # Technical documentation

Development

Godot Editor Setup

  1. Open godot/project.godot in Godot 4.6+
  2. Go to Project → Project Settings → Plugins
  3. Enable SolanaSDK (if testing wallet login)
  4. Scenes live in godot/scenes/, scripts in godot/scripts/

Testing

  • Demo: Download the latest release from Releases
  • Desktop: Run scenes directly in Godot editor or call main.py with a python setup
  • Android: Build APK and test on device with any web3 wallet/social login
  • Web: Portfolio/metrics dashboard at celkeys.io (coming soon)

Roadmap

Phase Timeline Features
Soft Launch Q2 2026 Level 1 (Day-Time), Matrica OAuth, Energy system
Global Launch Q3 2026 Level 2 (Night Time), Solana NFT Profiles, Store, Unique abilities
Level 3 Q4 2026 Level 3 (Snow), Unique abilities, Swipe mechanics
Level 4+ Ecosystem Q1 2027+ Level 4 (Tron Grid/Miami), Trilogy games, Cross-game portability

License

GPL-3.0 + Commons Clause

See LICENSE for full details.

Summary:

  • ✅ Open source: study, modify, contribute
  • ✅ Personal use, education, portfolio projects
  • ❌ No commercial use: can't sell or monetize derivatives
  • ℹ️ Creator retains full commercial rights to CtrlN

For licensing inquiries: celkeys@proton.me

Credits

Developer: Celshade — game design, programming, player sprites/effects and animation, UI design, infra, marketing, collabs, community admin

Community Artists:

  • Psy — Level background and obstacle art/animation
  • MomoBones — Concept and logo art

<3 indie games

Contact