> For the complete documentation index, see [llms.txt](https://raster.gitbook.io/zh-hans_choicescript-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://raster.gitbook.io/zh-hans_choicescript-guide/choicescript-zhi-nan.md).

# 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)探索。（点击超链接跳转。）