# ChoiceScript 指南

> 王洛木：恭喜你发现了这里，目前官方指南部分已经烤完了。社区的部分慢慢随性慢慢烤咯。

## 声明

* 本指南为[王洛木](https://raster.team/)出于兴趣爱好自发翻译，与 [ChoiceScript 官方](https://www.choiceofgames.com/)没有任何关系。
* 除非另有说明，否则本指南里出现的所有图片，以及 "CHOICE OF GAMES" 标识均为 [Choice of Games LLC](https://www.choiceofgames.com/) 或其它持有者所有，与本指南的汉化者没有任何关系。

## 如何使用？

本指南分为两个部分，第一部分为官方指南，这部分内容囊括了 ChoiceScript 的基础操作，**建议从这一部分开始阅读。**

内容翻译自官方教程 (Make Your Own Games)：<https://www.choiceofgames.com/make-your-own-games/choicescript-intro/>

***

另一部分为社区指南，这部分内容来自 Wikia（现在改名为 Fandom）。地址是：<https://choicescriptdev.fandom.com/wiki/ChoiceScript_Wiki>

这部分内容除了再次说明了 ChoiceScript 的基础操作之外，还解释了很多进阶操作。

## 王洛木的建议

以下建议仅仅只是本人在使用 ChoiceScript 时的一些拙见：

* ChoiceScript 是一个非常非常严格的脚本，好处是稳如老狗，坏处是你想做”漂亮“的东西阻力就非常强。不过……互动小说 (IF) 还要啥自行车？专注内容而非花里胡哨的东西。如果你想要一个好看的外观，或者更多对于文本的操控，请[使用 Twine 搭配故事结构](https://blog.raster.team/post/Tutorial_Twine-Chapbook-Guide/)或者直接用 Renpy 做视觉小说 (VN) 而非互动小说 (IF)。
* 只需要有 [Visual Studio Code](https://code.visualstudio.com/)，并下载一个 ChoiceScript 语法插件就可以开始写了，中间有任何问题都会直接给你标注出来，相当的方便。但是如果你喜欢客户端，你可以去看看[开发工具](/zh-hans_choicescript-guide/she-qu-zhi-nan/ji-chu-jiao-cheng/kai-fa-gong-ju.md)。
* 从左边的导航栏翻到最下面可以看我踩过的坑，还有我保存过的关于 ChoiceScript 的笔记和他们论坛里厉害的帖子。
* 我个人推荐在开发的时候就是用 CJW 的存档系统来帮助调试。（这部分等我肉烤的差不多了过来写。）

## 开始

从[官方指南](/zh-hans_choicescript-guide/guan-fang-zhi-nan/choicescript-jian-jie.md)开始，或者从[社区维基](/zh-hans_choicescript-guide/she-qu-zhi-nan/zhu-ye.md)探索。（点击超链接跳转。）


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://raster.gitbook.io/zh-hans_choicescript-guide/choicescript-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
