ASECOのインストール

DedicatedServer(TrackManiaゲームサーバ専用アプリ)の支援ツール。
Track毎のコースレコードの記録、Trackの評判投票(karma)、Chatコマンドによるサーバ管理などが行える。

• 準備
• インストール
• 初期設定
• 起動・終了
• 補足事項

必要環境

• DedicatedServerが動作しているコト
• ASECOそのものはPHPスクリプトのため、PHP 5.2.0以降
• コースレコード他の記録にMySQL 5.0以降
• Windowsであれば、xamppに必要環境が全部入っているので便利
• 文字コードUTF-8で編集できるテキストエディタがあると良い・・・というか必須かも

準備

(WindowsXPを基準にしています)

• xamppを利用するのであればインストールする
  MySQLとApacheをインストール
• MySQL上にASECOで使用するデータベースを作成する
  ASECOを適当なフォルダに解凍して、localdbフォルダにあるaseco.sqlをテキストエディタで開きデータベース名を確認

  CREATE DATABASE `aseco121`;
  USE `aseco121`;

  「スタート」→「すべてのプログラム」→「アクセサリ」→「コマンドプロンプト」を開き
  ASECO用のデータベースを作成する

  Microsoft Windows XP [Version 5.1.2600]
  (C) Copyright 1985-2001 Microsoft Corp.
  
  C:\Documents and Settings\WinXPユーザー名>cd c:\xampp\mysql\bin
  
  C:\xampp\mysql\bin>mysql.exe -u root -p
  Enter password: ********** (← 初回は新規パスワード作成となるハズ)
  Welcome to the MySQL monitor.  Commands end with ; or \g.
  Your MySQL connection id is 13
  Server version: 5.0.51a Source distribution
  
  Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
  
  mysql> source (ASECOを解凍したフォルダ)\localdb\aseco.sql
  Query OK, 1 row affected (0.02 sec)
  
  Database changed
  Query OK, 0 rows affected (0.02 sec)
  
  Query OK, 0 rows affected (0.01 sec)
  
  Query OK, 0 rows affected (0.00 sec)
  
  Query OK, 0 rows affected (0.00 sec)
  
  mysql>
  

• ASECO用のアカウントを作成してデータベース aseco121に対する全権限を与える

  mysql> GRANT ALL ON aseco121.* TO (ASECO用アカウント名)@localhost IDENTIFIED BY '(パスワード)';
  Query OK, 0 rows affected (0.03 sec)
  
  mysql> FLUSH PRIVILEGES;
  Query OK, 0 rows affected (0.00 sec)
  
  mysql>
  

  「アカウント名@localhost」の部分は重要
  これにより、「localhost」(同じPC)上からしか接続を受け付けないことになり、アカウント名・パスワードが漏れても外部からMySQLへ接続することができなくなる。
• xamppであればブラウザから簡単に↑の操作ができるphpMyAdminが一緒にインストールされているが詳しい使い方はググってください

インストール

適当なところにフォルダを作成し、「aseco.php」とnewinstallフォルダの中身をコピー
includes、logs、plugins、styles、typesフォルダを、フォルダごとコピー
以下のようになる

(ASECOフォルダ)┬ \includes\ ─ basic.inc.php ... 等
               ├ \logs\ ─ 空フォルダ
               ├ \plugins\ ┬ \rasp\ ─ plugin.matchsave2.php ... 等
               │           └ plugin.about.php ... 等
               ├ \styles\ ─ blue.xml ... 等
               ├ \types\ ─ challenge.class.php ... 等
               ├ aseco.php
               ├ admingroups.xml
               ├ Aseco.bat
               ├ Aseco.sh
               ├ chatbot.xml
               ├ config.xml
               ├ help.tpl
               ├ jukebox.xml
               ├ localdb.xml
               ├ matchsave.xml
               ├ plugins.xml
               ├ pubdb.xml
               └ rasp.xml

Aseco.batをテキストエディタで開きPHPのPathを書き換える

set INSTPHP=C:\Program Files\php

↓↓↓↓↓

set INSTPHP=C:\xampp\php

初期設定

最低限確認するのはadmingroups.xml、config.xml、localdb.xml、plugins.xmlの４つ
UTF-8で編集できるテキストエディタを使う
(全角文字(2byte文字)を使わなければUTF-8でなくてもOK？)

• admingroups.xml
  ユーザーレベルによるASECOコマンド使用権限設定
  自分がASECO管理者として認識されるようにLoginIDを設定

  <SuperAdmin>
     ・・・
     <TM_LOGIN>(TrackManiaの自分のLoginID)</TM_LOGIN>
     ・・・
  </SuperAdmin>
  

• config.xml
  ASECOの基本設定
  DedicatedServerの設定にあわせる

    <tmserver>
      <login>SuperAdmin</login>
      <password>SuperAdmin</password>
      <ip>127.0.0.1</ip>
      <port>5000</port>
    </tmserver>
  

  <colors>～</colors>でテキストメッセージの色を設定できる
  <messages>～</messages>でASECOのメッセージを設定できるが日本語不可
• localdb.xml
  MySQLへのアクセス設定

    <mysql_server>127.0.0.1</mysql_server> (← IP:127.0.0.1は同じPC上を指す。このままでOK)
    <mysql_login>(MySQLでのASECO用アカウント名)</mysql_login>
    <mysql_password>(パスワード)</mysql_password>
    <mysql_database>(ASECO用に作成したデータベース名)</mysql_database>
  

• plugins.xml
  使用するプラグインの選択
  使用したいプラグインの<!--と-->を消す

  	<!-- <plugin>plugin.localdb.php</plugin> --> 

  ↓↓↓↓↓

  	<plugin>plugin.localdb.php</plugin>

  他のプラグインの行も同様

起動・終了

• 起動
  DedicatedServerが起動していることを確認してAseco.batを実行
• 終了
  
  どちらか
  • Aseco.batが実行されているコマンドプロンプトウィンドウを閉じる。
    この場合、ASECOが強制終了される
  • ゲームサーバにLoginして/admin asecorestart
    コマンド直前までの記録をデータベースに格納したうえで終了する
    が、Windows(Aseco.batで起動)だと無限ループになっているので、また起動してくる

補足事項

エラーでASECOが正常に起動しない場合、Windows(Aseco.batで起動)だと無限ループになっているので
エラー終了→ASECO起動→エラー終了→ASECO起動
を繰り返してしまいエラーメッセージが読み取れない。
こんな時は、Aseco.batに

～～(前略)～～
echo Program exit at %date% %time% - errorlevel %errorlevel% >> restart.txt
pause　　← この1行を追加
goto restart

REM if you want aseco to NOT restart itself automatically, add "pause" above the "goto restart" line

これでエラー終了時点でキー入力待ちになるので、ゆっくりエラーメッセージを読めます(;´ω`)