Create:Railway Operations

Adds train door control, station announcements, and ghost seats to Create mod. Features include schedule-based door operations with station direction following, broadcast audio playback on carriages, and invisible no-collision seats.

# Create: Railway Operations

[English](#english) | [中文](#中文)

---

## English

**Create: Railway Operations** is a NeoForge addon for [Create](https://github.com/Creators-of-Create/Create) that enhances train operations with schedule-based door control, station announcement broadcasts, and ghost seats.

### Features

**Schedule-Based Door Control**
- Add Door Control as a schedule condition to control which side doors open at stations.
- Configure direction: All / North / East / South / West.
- Follow Station mode: reads the station's own door setting while suppressing auto-open, so the schedule takes full control.

**Train Announcements (Broadcasts)**
- Add Train Announcement as a schedule condition to play audio on carriages.
- Audio plays via OpenAL with real-time positional tracking, following the carriage.
- Configurable delay with unit selection: Ticks / Seconds / Minutes.

**Audio Pack System**
- Audio packs load from `config/railway_operations/audio/` as `.zip` files or directories.
- `pack.json` supports simple mode (single file) and template mode (language + station name splicing).
- Server builds a binary bundle of all packs and syncs to clients during the **configuration phase** (before the player joins the world), using SHA-256 verification and chunked transfer — identical to `custom-train-door`'s sync pattern.
- On-demand lazy-load fallback for clients that miss chunks during sync.

**Ghost Seat**
- Invisible, no-collision seat based on Create's SeatBlock.
- Right-click or fall onto it to sit; entities walk through freely.
- Fully compatible with train contraption assembly.

### Commands

All commands require permission level 2.

| Command | Description |
|---------|-------------|
| `/railway reload` | Reload audio packs on the server |
| `/railway status` | Show loaded audio packs and broadcast counts |
| `/railway sync` | Push all audio packs to all connected players |

### Installation

1. Requires **Create 6.0.10+** and **NeoForge 21.1.219+** for Minecraft 1.21.1.
2. Place `railway_operations-1.0.0.jar` in the `mods/` folder on both server and client.
3. Place audio packs in `config/railway_operations/audio/` on the **server**.
4. Run `/railway reload` then `/railway sync` to push packs to online players.
5. New players joining will receive packs automatically during the configuration handshake.

### Audio Pack Format

Simple mode (single file):
```json
{
  "name": "Shanghai Bureau Fuxing EMU",
  "description": "Fuxing EMU Shanghai Bureau Broadcasts",
  "broadcasts": {
    "welcome": { "simple": "welcome.ogg" },
    "door_closing": { "simple": "door_closing.ogg" },
    "arrival": { "simple": "arrival.ogg" }
  }
}
```

Template mode (language + station splicing):
```json
{
  "name": "JR East E5",
  "broadcasts": {
    "arrival": {
      "template": { "zh": "arrival_zh.ogg", "en": "arrival_en.ogg" },
      "has_station": true
    }
  }
}
```

### Schedule Example

```
DESTINATION: Beijing South
  Group 1: [Announcement: door_closing, delay 12s] [Delay 15s]
  Group 2: [Door Control: Follow Station, 20s]
→ Announcement plays 3s before doors close.
```

---

## 中文

**Create: Railway Operations** 是基于 [Create](https://github.com/Creators-of-Create/Create) 的 NeoForge 附属模组,为列车运营增加时刻表车门控制、列车广播报站和幽灵坐垫功能。

### 功能

**时刻表车门控制**
- 在时刻表中添加车门控制条件,控制到站后开启哪一侧车门。
- 可选方向:全部 / 北侧 / 东侧 / 南侧 / 西侧。
- 跟随车站模式:读取车站自身车门设置并拦截自动开门,让时刻表完全接管车门时机。

**列车广播报站**
- 添加列车广播条件,在车厢上播放音频。
- 音频通过 OpenAL 实时位置追踪跟随车厢移动。
- 可配置播放延时及单位:Tick / 秒 / 分钟。

**音频包系统**
- 音频包从 `config/railway_operations/audio/` 加载,支持 `.zip` 文件和目录格式。
- `pack.json` 支持简单模式(单文件)和模板模式(语言+站名拼接)。
- 服务端将所有音频包打包为二进制 bundle,在玩家加入前的**配置握手阶段**通过分块传输同步到客户端,采用 SHA-256 校验 — 与 `custom-train-door` 同步机制完全一致。
- 懒加载回退:同步丢失的音频可在运行时按需获取。

**幽灵坐垫**
- 基于 Create 原版 SeatBlock 的透明无碰撞坐垫。
- 右键或摔落可乘坐,实体自由穿行。
- 完全兼容列车结构组装。

### 指令

所有指令需要权限等级 2。

| 指令 | 说明 |
|------|------|
| `/railway reload` | 重新加载服务端音频包 |
| `/railway status` | 查看已加载的音频包及广播数量 |
| `/railway sync` | 将全部音频包推送给所有在线玩家 |

### 安装

1. 需要 **Create 6.0.10+** 和 **NeoForge 21.1.219+**(Minecraft 1.21.1)。
2. 将 `railway_operations-1.0.0.jar` 放入服务端和客户端的 `mods/` 文件夹。
3. 在**服务端**的 `config/railway_operations/audio/` 放入音频包。
4. 执行 `/railway reload` 然后 `/railway sync` 推送给在线玩家。
5. 新玩家加入时会在配置握手阶段自动接收音频包。

### 音频包格式

简单模式(单文件):
```json
{
  "name": "上海局复兴号",
  "description": "复兴号动车组上海局报站广播",
  "broadcasts": {
    "始发欢迎词": { "simple": "始发欢迎词.ogg" },
    "关门前提示": { "simple": "关门前提示.ogg" },
    "终到广播": { "simple": "终到广播.ogg" }
  }
}
```

模板模式(语言+站名拼接):
```json
{
  "name": "JR东日本 E5系",
  "broadcasts": {
    "arrival": {
      "template": { "zh": "arrival_zh.ogg", "en": "arrival_en.ogg" },
      "has_station": true
    }
  }
}
```

### 时刻表配置示例

```
目的地: 北京南站
  条件组1: [列车广播: 关门前提示, 延时12s] [延时15s]
  条件组2: [车门控制: 跟随车站, 20s]
→ 关门前3秒播放提示,车门按车站方向开启。
```

Create:Railway Operations Team

profile avatar
Owner
  • 1
    Projects
  • 49
    Downloads

More from yasui_i