1. ゲーム コミュニティ札幌 製作者
Kawaz
1
ぼく盾で覚えるドキュメンテーションコメント

2. ゲーム コミュニティ札幌 製作者
Kawaz
2
自己紹介
HN Sakuriver
で社会人 Web のプログラマやっていま関係
す。
Kawazだと、プログラムを いているカメ書
は、今 Kawazで「Arcane と」
みるみら「 for PSVITA に」 参加中

3. ゲーム コミュニティ札幌 製作者
Kawaz
3
ぼく って盾 何
・2Dアクションで を にひきつけて していく ゲー敵 盾 倒 爽快
ダウンロードページ・
http://www.kawaz.org/projects/bokutate/

4. ゲーム コミュニティ札幌 製作者
Kawaz
4
スライド対象者
れっぽいプログラマー・忘
で する プログラマーさん・複数人 開発 同人
・Excelファイルを できない さん管理 皆
みんなで にゲーム ろうぜ快適 作 ！！

5. ゲーム コミュニティ札幌 製作者
Kawaz
5
今日のお話
・ぼく盾でのドキュメンテーションコメントにつ
いて
＊必ずしも必要なものではない。プロジェクトや
文化に応じて機会があったら使ってみてくださ
い。

6. ゲーム コミュニティ札幌 製作者
Kawaz
6
僕たてのスタンス
・多くの人にゲーム開発を経験してもらいたい
・新規参入の方も含めたプチゲープロジェクト
・Excelスキル低いけど、プログラムのメンテはしよう
↓
属人化を防止して、みんながプログラムを
いじれる体制を作ろう

7. ゲーム コミュニティ札幌 製作者
Kawaz
7
僕たてのプログラム担当構成
プログラムの各担当
Sakuriver
・ザコ敵
・マップ関連
・ほか雑用
フェルミウム
・主人公とお姫様
・スキル全般
プログラムの世界では、
「私の代わりはいくらで
もいるから」は
プロジェクトが整備
されている証拠

8. ゲーム コミュニティ札幌 製作者
Kawaz
8
同人ゲーム開発のあるある
・時間がない
・秘伝のコードが生まれて、神が
消 えると崩壊する
・詳細設計書を書くのは大変+メン
テができない
仕様が揃って、素材があるのに
ゲームが未完成とかもったいない
お化けが出ちゃうわ

9. ゲーム コミュニティ札幌 製作者
Kawaz
9
本説明の前に
って・詳細設計書 何・・・？
カメが していた のドキュメント・ 存在 古
ある では、 でも を っているというこ・由緒 地域 現在 伝統 守
と
(1). 処理内容
メソッド名 SkillEffect
戻り値 なし
引数 SkillBase スキルのインスタンス
etc
(1)-1. 敵を動かして、座標の更新処理を呼び出す
(1)-2. 敵からみたターゲットを設定する処理を呼ぶ
(1)-3. 地面への当たり判定について、メンバに設定
する
Excelファイルでいっぱい作るらしい

10. ゲーム コミュニティ札幌 製作者
Kawaz
10
詳細設計のExcelあるある
頑張って作った Excel ソースコード
ゲームの内容が、これだと
つまらないから変えようぜ
ソースコードだけ、更新されてしまう。
なんで変更したかも忘れる

11. ゲーム コミュニティ札幌 製作者
Kawaz
11
つらいから、こうしてみた
ソースコード
+
コメント

12. ゲーム コミュニティ札幌 製作者
Kawaz
12
は いから した一人 辛 提案

13. ゲーム コミュニティ札幌 製作者
Kawaz
13
書き方の例
タグの説明
Summary クラスやメソッドで行われる概要
Param
name=” ”パラメータ名 渡されるパラメータの名前
タグの中 パラメータのないよう
Returns 処理された結果の戻り値

14. ゲーム コミュニティ札幌 製作者
Kawaz
14
今回の方針
publicとprotectedにはタグによる を える説明 加
⇒ クラスまたは、 に するということは子 全体 公開
の で ってもらう があるという え他 機能 使 意図 考
⇒privateについては、 ったけれど迷
メンバーの を とす があるので開発 開発速度 落 可能性
にしました。対象外
* ここら はプロジェクトの みでよろしくお いします辺 好 願

15. ゲーム コミュニティ札幌 製作者
Kawaz
15
ある程度標準化された
クラスを整備するといいことあるの？
デバッグツールなどで利用できたり拡張しやすい
マップの定数情報が提供されている
⇒自動スクロールで○秒時にどこにいるか
敵クラスの整備がされている
⇒各エリアごとの敵情報を表示する
任意のステージで遊びたい
⇒ステージ選択ツール
直接の実装者以外が開発できるので、
作業を並列にできる

16. ゲーム コミュニティ札幌 製作者
Kawaz
16
補足
・VisualStudioでは、TODOコメントが えたので の使 仮 素
とか で するものはチケットではなく材 後 対応 TODOコメント
で すようにしました。残

17. ゲーム コミュニティ札幌 製作者
Kawaz
17
プログラム開発の遷移
の で する頭 中 設計
メモしたり、
docコメントで する整理
まとまったところで、
する。実装
チームの中で作る内容がまとまった後の
お話だよ
さそうだったら、良
dropboxへアップ
プログラムとして仮の箇所は、TODO
コメント
違和感を感じる部分はSkypeで確認したり
チケットを上げて修正

18. ゲーム コミュニティ札幌 製作者
Kawaz
18
生成ツールのおはなし
SandCastleを使いました。

19. ゲーム コミュニティ札幌 製作者
Kawaz
19
ダウンロードしてみた

20. ゲーム コミュニティ札幌 製作者
Kawaz
20
実行してみた

21. ゲーム コミュニティ札幌 製作者
Kawaz
21
成功したので見てみる

22. ゲーム コミュニティ札幌 製作者
Kawaz
22
見たときに変なのを見つけた
・redmineでコードレビューのチケットで担当者に依頼

23. ゲーム コミュニティ札幌 製作者
Kawaz
23
僕が感じたメリット
・レビュー時点で、ソースコードと設計の確認ができる
・変な書類ファイルが増えない
・闇のコメントアウトを防げるようになる
・謎バグをある程度防げる
・プログラムの結合時間が減るので、
・レベルデザインの便利ツール
・ゲームのプレイやテストをしての修正や改善
に使える時間が増えた！？

24. ゲーム コミュニティ札幌 製作者
Kawaz
24
おまけ
フリー素材以外で、開発したソースコードなどを配布して
います。
ぼくはキミの盾 開発キット
http://www.kawaz.org/commons/1853/
すこしでも役に立ったら、それはとっても嬉しいなって

25. ゲーム コミュニティ札幌 製作者
Kawaz
25
最後に
ご ありがとうございました。清聴