aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore5
-rw-r--r--README.md38
-rw-r--r--chapter0/chap0.tex1
-rw-r--r--main.tex29
-rw-r--r--preface.tex30
5 files changed, 103 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..90e6aa0
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+*.pdf
+*.log
+*.aux
+*.out
+*.toc
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1ee6b12
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Virtools 脚本指南
+## ——一个面向 Ballance 玩家的介绍
+
+### 简介
+
+这是一本向 Ballance 玩家介绍 Virtools 脚本指南的小册子。
+如果您对 Ballance 和 Virtools 两个名字均感到陌生,
+您可能需要重新思考您正在阅读这段文字的原因。
+
+这本小册子是一个开放的工程。欢迎任何人使用 GitHub 上的 Issue Tracker
+提出修改意见,或者发起 Pull Request 进行直接的修订。
+
+整个工程采用 CC BY-SA 4.0 协议授权。截图等材料中包含 Virtools S.A. (3DVIA)
+所持著作权的部分。本工程的作者相信这些材料用于该工程中属于「合理使用」
+的范围。
+
+### FAQ
+
+- 如何生成 PDF ?
+
+ 需要事先准备带有 CTeX 包的 TeX Live 软件。
+
+ 在工程根目录下执行 `xelatex main.tex` 即可生成可阅读的 `main.pdf`。
+
+- 如何贡献?
+
+ 所有人都可以使用 GitHub 的 Issue Tracker 提出修改意见。如果您了解 GitHub
+ 的基本工作流程,可以 fork 该工程,在做出更改之后发起 Pull Request 。
+
+- 为何使用 LaTeX ?
+
+ 传统的文档格式对版本控制系统不友好, Markdown 在排版方面又显得力不从心,
+ 故而选择了 LaTeX 。
+
+- 如何入门 TeX ?
+
+ [这里](https://zh.wikibooks.org/wiki/LaTeX)有一个相当不错的 LaTeX
+ 入门手册。
diff --git a/chapter0/chap0.tex b/chapter0/chap0.tex
new file mode 100644
index 0000000..d490d09
--- /dev/null
+++ b/chapter0/chap0.tex
@@ -0,0 +1 @@
+\chapter{快速入门}
diff --git a/main.tex b/main.tex
new file mode 100644
index 0000000..fa58631
--- /dev/null
+++ b/main.tex
@@ -0,0 +1,29 @@
+\documentclass[oneside]{book}
+\usepackage[cm]{fullpage}
+\usepackage[UTF8]{ctex}
+\usepackage{graphicx}
+\usepackage[pdfborder={0 0 0}]{hyperref}
+\setcounter{chapter}{-1}
+
+\title{Virtools 脚本指南\\ \large 一个面向 Ballance 玩家的介绍}
+\author{Chris Xiong}
+\begin{document}
+\begin{titlepage}
+ \makeatletter
+ \centering
+ \vspace*{3cm}
+ {\huge \@title \par}
+ \vspace{1cm}
+ {\@author}
+ \vfill
+ {本书全部内容皆采用 CC BY-SA 4.0 协议授权。\par}
+ \def\padd#1{\ifnum #1<10 0\fi\the#1}
+ {生成日期:\the\year-\padd\month-\padd\day}
+ \vfill
+\end{titlepage}
+\renewcommand{\contentsname}{目录}
+\tableofcontents
+\input preface.tex
+\input chapter0/chap0.tex
+\end{document}
+
diff --git a/preface.tex b/preface.tex
new file mode 100644
index 0000000..b804911
--- /dev/null
+++ b/preface.tex
@@ -0,0 +1,30 @@
+\clearpage
+\phantomsection
+\chapter*{前言}
+\addcontentsline{toc}{chapter}{前言}
+得益于国内(曾经)对盗版软件的放纵,许多人通过一个叫做 Ballance
+的游戏接触到了一个定价不菲%
+\footnote{\$5000,\underline{\href{https://web.archive.org/web/20151016140349/http://www.gamasutra.com/view/feature/131377/product_review_virtools_dev_20.php}{见此}}}%
+的 3D 应用开发环境 "Virtools" 。甚至此环境的一个中文社区在其简介中都提到了%
+「众多 Virtools 爱好者就是从这款游戏开始认识研究 Virtools 软件的,%
+并且有数个自做的版本在网上流传。」%
+\footnote{\underline{\url{http://tieba.baidu.com/p/2256977468}},十楼}。%
+但是多年来,涉及到 Virtools 作为 3D 应用开发环境所拥有的编程功能者%
+少之又少。最主要的原因当然是因为关注度最高的制图方向并不需要相关的功能。
+\par
+不过从 2018 年起,事情发生了转变。年初, 2jjy 和我合作解密了全部 Ballance
+的游戏脚本。2018 年底,我发现了在适用于原版游戏的地图中注入脚本的方式。%
+这两个发现,在国内的 Ballance 玩家里吹起了一股学习 Virtools 脚本的新风。%
+奈何当下已难觅得 Virtools 脚本的中文资料,遂起了编写本指南的念头。
+\par
+Virtools 脚本所用的图形化编程方式向来有直观易用的名声,%
+甚至获得了「使美工也能学会编程」的美誉%
+\footnote{链接同注2,四楼}。相信读者在投入些许时间后,一定能对 Virtools
+脚本有相当程度的了解。同时本书在最后还将为有相关基础的读者简单地介绍
+Virtools SDK 以及相关的高级内容。
+\par
+需要注意的是,本书的假想读者是对 Virtools 脚本感兴趣的 Ballance 玩家。%
+由于在本书写作的时候,Virtools 已经宣布废弃近十年,
+如果您单纯是想学习 Virtools 的相关技术,强烈建议您转向其他更新的开发技术。%
+游戏有情怀可言,但时间对过时的技术来讲是毫不留情的。
+\clearpage