Godot Line - Dancing Line Game Template for Godot 4.6

A complete Dancing Line game template for Godot 4.6 featuring auto-move gameplay, procedural road generation, checkpoint & revive system, auto-play, beatmap import, and a modular trigger architecture.

Description

GodotLine is a complete Dancing Line game template for Godot Engine 4.6 that lets you build rhythm-based line-runner levels with minimal setup. Extracted from the ShinnLine project and aligned with the popular Bingyan (冰焰) Template v3/v4, it lowers the barrier for level designers who want to create, publish, and share their own Dancing Line experiences.

What You Get

Complete Core Gameplay

The player auto-moves along a 3D path. Tap/click to toggle between two alternating directions. Time your turns to follow the road and avoid falling.

Procedural Road Generation

The RoadMaker system dynamically generates floor segments between player positions in real-time.

Game State Machine

Five states (Waiting → Playing → Moving → Died → Completed) managed by a static LevelManager.

Checkpoint & Revive System

Full-state capture including player transform, camera, fog, lights, material colors, music position, and animation time. Crowns, heart checkpoints, and gem collection included.

Auto-Play & Guidance

AutoPlayController generates turn triggers from guidance boxes; ghost player (FakePlayer) for path previews.

Trigger System

Three coexistence modes (pure component, self-container, legacy Area3D) with 20+ trigger types:

• Jump
• Speed
• Teleport
• KillPlayer
• ChangeDirection
• SetFog
• SetActive
• SetMaterialColor
• PlayAnimator
• CameraTrigger
• EventTrigger
• And more...

Dual Camera Systems

Modern Tween-based CameraFollower and legacy OldCameraFollower with smooth transitions and shake effects.

Audio System

One-shot SFX and music playback with fade-out, plus configurable latency offset for Bluetooth headphones.

Animator System

Position, rotation, and scale animators with local/global variants and revive support.

Beatmap Import

Editor tools (NoteReader, BeatmapReader) convert .osu beatmap files into level geometry and guidance boxes.

MPM Importer

Editor plugin for importing .mpm camera and animation data.

Unity-to-Godot Port Toolkits

Helper scripts for migrating content from Unity-based templates.

Architecture Highlights

• Modular Trigger Design: New triggers are pure Node3D components under a BaseTrigger. Just implement func trigger(body: Node3D)."
• **. Singleton Pattern**: Key nodes usestatic var instance` for easy global access.
• Resource-Driven Settings: Camera, fog, light, ambient, and color settings stored as Resource classes.
• Layered Physics: Player (1), BaseFloor (2), BaseWall (3) with proper collision masking.

Recommended For

• Building Dancing Line / rhythm-runner levels without coding from scratch
• Migrating existing Bingyan Template v3/v4 levels to Godot
• Publishing levels to the GodotLineCollection ecosystem

Requirements

• Godot Engine: 4.6 or higher
• Renderer: Mobile renderer recommended
• Physics: Jolt Physics (on separate thread; included in Godot 4.x)

How to Use

1. Download this asset
2. Open project.godot in Godot Engine 4.6+
3. Open the sample scene at #Template/[Scenes]/Sample/Sample.tscn
4. Press F5 to play

Controls

Project Structure

godot-line/
├── #Template/          # Core template system (scripts, scenes, resources)
│   ├── [Scripts]/      # Game logic, triggers, camera, audio, animators, etc.
│   ├── [Scenes]/       # Sample and default scenes
│   ├── [Resources]/    # Textures, models, shaders, UI assets
│   ├── [Materials]/    # Material .tres files
│   └── [Music]/        # Music assets
├── addons/             # Godot plugins (Template toolbar, MPM importer)
├── Main.tscn           # Main scene file
├── project.godot       # Project configuration
└── CONTRIBUTING.md     # Contribution guidelines

License

This project is open source under the MIT License.

Links

• GitHub: https://github.com/meny2333/godot-line
• Documentation: https://www.cnblogs.com/mmme/p/-/tutorial
• Collection: https://github.com/meny2333/GodotLineCollection