つくば文庫 > ソフトウェア工房 > The "Peko" project

# The "Peko" project

## Project Menu

- "Peko" project
  - Welcome!
  - News
  - プロジェクト状態
  - ライセンス
- Documentation
  - PVNS イントロダクション
  - QuickStart ガイド
  - PSML-Scene ショートリファレンス
  - PVNS カスタマイズガイド
- Download
  - PVNS releases
- Get Involved
  - プロジェクト概要
  - 協力者募集
  - Mailing Lists
  - CVS Repository
  - Bug Tracking System

## "Peko" Visual Novel System：QuickStart Guide

この文書は、"Peko" Visual Novel System (以下 PVNS)をとりあえず動かしてみたい、使ってみたいという方のための簡単な入門書です。PVNS そのものについては、「PVNS イントロダクション」を参照してください。

なお、この文書で紹介する実際の作業の例は Windows XP Professional 上で行ったものです。それ以外の環境の方は、ファイルパスや GUI の用語などを適宜読み替えて作業してください。

### Table of Contents

### 1. 必要なものの入手

まず、PVNS を試すのに必要なものを準備します。下記リストに挙げたものを入手してください。

- Java2 Runtime Environment 1.4
- ZIP 形式の圧縮ファイルを解凍できるツール
- PVNS アーカイブ

Java2 Runtime Environment (JRE) 1.4

  Java2 の実行環境 (Java VM) です。PVNS は Java2 Platform Standard Edition (J2SE) 1.4 を基盤技術に採用していますので、動作させるには J2SE 1.4 に準拠した Java VM がシステムにインストールされている必要があります。最新の JRE 1.4.2 のダウンロードは Sun Microsystems の Java Technorogy Home Page から、J2SE download より行うことができます。JRE のインストールについては、JRE のマニュアルに従ってください。

ZIP 形式の圧縮ファイルを解凍できるツール

  PVNS は現在 ZIP アーカイブとして配布されていますので、ZIP アーカイブを解凍できるツールがないと全く利用できません。解凍ツールはインターネット上でフリーで配布されているものが沢山ありますので、お持ちでない方はまず最初に入手してください。正常に解凍することができれば何でもかまいません。なお、ZIP アーカイブの解凍方法については、このマニュアルでは取り扱いません。使用するツールのマニュアルに従ってください。

PVNS アーカイブ

  PVNS の一次配布は SourceForge.jp の プロジェクト："Peko" Visual Novel System で行っています。

### 2. テンプレートゲームの準備

次に、これから作成するゲームのスケルトンとなるテンプレートゲームを開発用に作業ディレクトリにデプロイ (インストール) します。

デプロイの手順を以下に示します。

1. 最初に、ゲームを開発するための作業ディレクトリを準備します。ここでは、`C:\hello-world` に作成します。
2. 次に、PVNS アーカイブを適当な場所に解凍します。解凍すると以下のディレクトリが出来ます。

   図2.1：解凍後の PVNS ディレクトリ

   表2.1：PVNS アーカイブの構成
   ディレクトリ名 | 解説
   --- | ---
   docs | マニュアル・API ドキュメントが置かれます。
   lib | PVNS runtime および、依存ライブラリが置かれます。
   src | PVNS runtime のソースコードが置かれます。
   templates | PVNS でゲームを開発するためのテンプレートゲームが置かれます。

3. templates ディレクトリから、目的にあったテンプレートゲームを選択します。templates ディレクトリの下には、予めいくつかの典型的な設定を施したテンプレートゲームが、それぞれ ZIP 形式の圧縮書庫として置かれています。

   表2.2：templates ディレクトリの構成
   圧縮書庫名 | 解説
   --- | ---
   float-window.zip | テキストキャンバスがウィンドウ形式に設定されたテンプレートゲーム
   full-screen.zip | テキストキャンバスがフルスクリーン形式に設定されたテンプレートゲーム

4. 選択した圧縮書庫を、手順 1 で作成した作業ディレクトリに解凍します。

   図2.2：解凍後の作業ディレクトリ

以上で、デプロイは完了です。

### 3. ゲームの起動

デプロイが完了したら、サンプルを起動してみましょう。

#### 3.1 起動方法

コマンドプロンプト、または、スタートメニューの「ファイル名を指定して実行」に次のように入力して、Enter キーをクリックします。

`java -jar C:\hello-world\system\peko.jar`

Windows 2000 以降では、エクスプローラから、`peko.jar` をダブルクリックすることでも起動できます。`peko.jar` は、作業ディレクトリの下にある `system` ディレクトリの中に置かれています。

ゲームが起動すると、図3.2 に示すウィンドウが表示されます。(画像は 50% に縮小されています)

図3.2：タイトル画面

#### 3.2 基本操作

PVNS の基本操作について説明します。

##### 3.2.1 タイトル画面

ゲームを起動すると、タイトル画面が表示されます。

図3.3：タイトル画面

タイトル画面には、タイトルメニューを選択するための三つの選択肢ボタンが表示されます。どのボタンを選択するかは、キーボードの [↑][↓] で選択したいボタンを選んでから [ENTER] キーをクリックするか、マウスで選択したいボタンを左クリックすることで、決定します。

最初から始める
  ゲームを最初のシーンから始めます。
続きから始める
  以前セーブした場所からゲームを再開します。このメニューを選択すると、ロードダイアログが表示されますので、ロードしたいセーブデータを選択して下さい。
ゲームを終了する
  ゲームを終了し、PVNS をシャットダウンします。

##### 3.2.2 ゲーム画面

図3.4：ゲーム画面

基本操作
  キーボードの `ENTER` キー、またはマウスの左ボタンをクリックすることでストーリーを読み進めていきます。
選択肢
  途中、選択肢が表示されることがあります。どの選択肢を選択するかは、キーボードの [↑][↓] で選択肢を選択した状態で [ENTER] キーをクリックするか、または、マウスで選択したい選択肢を左クリックすることで、決定します。
セーブ
  プレイの途中でセーブする場合は、キーボードで [Ctrl＋S] を押すか、メニューから [システム]-[セーブ] を選択してください。セーブダイアログが表示されますので、ダイアログ上でセーブする場所を選択してください。
ロード
  セーブデータを読み込んでプレイの状態を復元する場合は、キーボードで [Ctrl＋O] を押すか、メニューから [システム]-[ロード] を選択してください。ロードダイアログが表示されますので、ロードしたいセーブデータを選択してください。
終了
  ゲームを終了する場合は、キーボードで [`Ctrl＋Q`] を押すか、メニューから [システム]-[終了] を選択する、もしくは、ゲーム画面ウィンドウを閉じてください。

##### 3.2.3 セーブ／ロード

//TODO: 説明はまだ準備中です！

### 4. 少しいじってみる

PVNS で動作するゲームを作る前に、ゲーム開発のイメージをつかむために、テンプレートゲームを少しいじってみましょう。

//TODO: 説明はまだ準備中です！

### 5. 実際にゲームを作ってみる

//TODO: 説明はまだ準備中です！