Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ivan-1f/phichain/llms.txt

Use this file to discover all available pages before exploring further.

What is Phichain?

Phichain is a powerful charting toolchain for Phigros, a rhythm game featuring dynamic judgment lines and innovative gameplay mechanics. Built from the ground up with Rust and Bevy, Phichain provides charter creators with a modern, high-performance editor for designing custom charts.
Phichain is still in early stages of development. Expect incomplete features and unexpected behavior as the project evolves.

What is Phigros?

Phigros is a unique rhythm game where notes appear along judgment lines that can move, rotate, and transform across the screen. Unlike traditional rhythm games with static lanes, Phigros offers dynamic, visually engaging gameplay that challenges players to track multiple moving lines simultaneously. Charting for Phigros involves:
  • Placing notes (Tap, Drag, Hold, Flick) along judgment lines
  • Choreographing line movements and rotations synchronized with music
  • Creating visual effects through line transformations
  • Timing note placement with the song’s beat and rhythm

Key Features

Visual Editor

Phichain provides an intuitive visual interface for chart creation:
  • Real-time preview of note placement and line movements
  • Timeline-based editing with precise beat alignment
  • Inspector panels for detailed note and event properties
  • BPM list management for songs with tempo changes

Multi-Format Support

Import and export charts in multiple formats:
  • Official Phigros format - Native .json chart format
  • RPE (Re:PhiEdit) - Compatibility with existing charting tools
  • Seamless conversion between formats via phichain-converter

Built-in Playback

Test your charts directly within the editor:
  • Full game simulation with accurate physics
  • Audio playback synchronized with chart events
  • Visual feedback for note timing and judgment
  • Adjustable playback speed for testing

Performance-Focused Architecture

Built on Rust and Bevy game engine:
  • Native performance without runtime overhead
  • Efficient rendering of complex charts with many notes
  • Low-latency audio playback for precise timing
  • Cross-platform support (Windows, Linux, macOS)

Architecture

Phichain is organized as a Rust workspace with specialized crates:
  • phichain-editor - Main visual editor application
  • phichain-chart - Core chart data structures and logic
  • phichain-game - Game simulation and playback engine
  • phichain-renderer - Chart rendering utilities
  • phichain-converter - CLI tool for format conversion
  • phichain-compiler - Chart compilation and optimization
  • phichain-assets - Asset management and loading
This modular architecture allows each component to be used independently or composed together for different use cases.

Community

Join the Phichain community to share charts, get help, and stay updated:

Next Steps

Installation

Download and install Phichain on your system

Quickstart

Create your first chart in minutes

Build docs developers (and LLMs) love