From faebd90262a2e3e92c02690fb0e785be12228f97 Mon Sep 17 00:00:00 2001 From: Darkelarious Date: Sun, 23 May 2021 12:39:15 +0200 Subject: md readme --- CHANGELOG | 30 ------- COPYING | 25 ------ COPYING.md | 29 +++++++ Changelog.md | 29 +++++++ README.md | 205 ++++++++++++++++++++------------------------- util/masterwebinterface.pl | 2 +- 6 files changed, 150 insertions(+), 170 deletions(-) delete mode 100644 CHANGELOG delete mode 100755 COPYING create mode 100755 COPYING.md create mode 100644 Changelog.md diff --git a/CHANGELOG b/CHANGELOG deleted file mode 100644 index 0270dd2..0000000 --- a/CHANGELOG +++ /dev/null @@ -1,30 +0,0 @@ -AUTHOR - Darkelarious - http://333networks.com - darkelarious@333networks.com - -CHANGELOG -3.0.5 - * added more functionality to the JSON API module - * JSON API includes players in server details - * JSON API links directly to the recommended map thumbnail if available, or - to default thumbnail if not available. - - -3.0.4 - * fix use of uninitialized values in string output - -3.0.3 - * support for postal2 map thumbnails - -3.0.2 - * support for rune map thumbnails - -3.0.1 - 27 Sep 2017 - * do not display blacklisted servers in serverlists - * show colored tags for direct uplinks, blacklisted- and passworded servers - -3.0.0 - 25 Sep 2017 - * point of reference - * structural rework to be compatible with MasterServer-Perl >= 2.4.0 - * continuation from MasterServer-SimpleInterface diff --git a/COPYING b/COPYING deleted file mode 100755 index 021a553..0000000 --- a/COPYING +++ /dev/null @@ -1,25 +0,0 @@ -Copyright (c) 2005-2017 Darkelarious & 333networks.com - -Permission is hereby granted, free of charge, to any person obtaining -a copy of this software and associated documentation files (the -"Software"), to deal in the Software without restriction, including -without limitation the rights to use, copy, modify, merge, publish, -distribute, sublicense, and/or sell copies of the Software, and to -permit persons to whom the Software is furnished to do so, subject to -the following conditions: - -The above copyright notice and this permission notice shall be included -in all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -All Unreal Tournament related materials are based on Epic Games' Unreal -Tournament. UNREAL (c)1999 Epic Megagames, Inc. All Rights Reserved. Distributed -by GT Interactive Software, Inc. under license. UNREAL and the UNREAL logo are -registered trademarks of Epic Megagames, Inc. diff --git a/COPYING.md b/COPYING.md new file mode 100755 index 0000000..dd749eb --- /dev/null +++ b/COPYING.md @@ -0,0 +1,29 @@ +# MasterServer-WebInterface +--- + +## COPYING +Copyright (c) 2005-2017 Darkelarious & 333networks.com + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +All Unreal Tournament related materials are based on Epic Games' Unreal +Tournament. UNREAL (c)1999 Epic Megagames, Inc. All Rights Reserved. Distributed +by GT Interactive Software, Inc. under license. UNREAL and the UNREAL logo are +registered trademarks of Epic Megagames, Inc. diff --git a/Changelog.md b/Changelog.md new file mode 100644 index 0000000..d57e06b --- /dev/null +++ b/Changelog.md @@ -0,0 +1,29 @@ +AUTHOR + Darkelarious + http://333networks.com + darkelarious@333networks.com + +CHANGELOG +3.0.5 + * added more functionality to the JSON API module + * JSON API includes players in server details + * JSON API links directly to the recommended map thumbnail if available, or + to default thumbnail if not available. + +3.0.4 + * fix use of uninitialized values in string output + +3.0.3 + * support for postal2 map thumbnails + +3.0.2 + * support for rune map thumbnails + +3.0.1 - 27 Sep 2017 + * do not display blacklisted servers in serverlists + * show colored tags for direct uplinks, blacklisted- and passworded servers + +3.0.0 - 25 Sep 2017 + * point of reference + * structural rework to be compatible with MasterServer-Perl >= 2.4.0 + * continuation from MasterServer-SimpleInterface diff --git a/README.md b/README.md index b4fbe0f..e8701d0 100755 --- a/README.md +++ b/README.md @@ -1,118 +1,95 @@ # MasterServer-WebInterface +--- Website for the 333networks MasterServer implementation in Perl. -========= - -# DESCRIPTION - - This repository contains software for a web interface to display information - obtained by the 333networks MasterServer package for the support of various - legacy games. The software was written Darkelarious to soften the effects of - GameSpy (GameSpy Industries, Inc.) shutting down their masterserver service. - - A masterserver is a program that maintains a list of online game servers and - presents this list to clients (gamers, players) who request the list of game - addresses. The 333networks Masterserver is a software framework that allows - gamers/players to browse online games. - - More information about the masterserver and variations on the protocol by - 333networks can be found online at - http://333networks.com/masterserver - http://wiki.333networks.com/index.php/MasterServer - -# AUTHOR - Darkelarious - http://333networks.com - darkelarious@333networks.com - -# REQUIREMENTS - - Apache/httpd - - Postgresql, MySQL or SQLite3 - - Perl 5.10 or above - - The following CPAN modules: - DBI - DBD::Pg / DBD::SQLite / DBD::mysql - IP::Country::Fast - Image::Size - TUWF (http://dev.yorhel.nl/tuwf) - -# INSTALL - - THE MASTER SERVER IS WRITTEN ON LINUX. IF YOU WANT TO RUN THE SOFTWARE IN - MICROSOFT WINDOWS OR APPLE OSX, IT MAY NOT WORK WITHOUT MODIFICATIONS. - - This repository consists of Perl modules and is run by a http deamon. First, - the MasterServer-Perl repository should be installed and configured in order - to run this web interface. The contents of this repository can be extracted - in the same root folder as MasterServer-Perl. - -# CONFIGURATION - - The 333networks masterserver interface comes with options. These options are - found in configuration file "data/webinterface-config.pl". Comments in the - file give a brief description. Below, the configuration is discussed in - further detail. - - Database login information - - The masterserver interface supports different database types. This must be the - same database (and type) as you specified in your MasterServer-Perl config. - - # postgresql - db_login => ['dbi:Pg:dbname=masterserver', 'user', 'password'], - - # sqlite - db_login => ["dbi:SQLite:dbname=$ROOT/data/masterserver.db",'',''], - - You also need to (un)comment the right database module in the - masterwebinterface.pl file to load the correct driver. - - Apache settings - - LoadModule rewrite_module modules/mod_rewrite.so - AddHandler cgi-script .cgi .pl - - Vhost configuration for the Web Interface (assuming you extracted it in the - same folder as your MasterServer-Perl installation): - - # - # Master Web Interface - # - - ServerAdmin master@yourdomain.com - ServerName master.yourdomain.com - - DocumentRoot "/server/MasterServer-Perl/s" - AddHandler cgi-script .pl - - RewriteEngine On - RewriteCond "%{DOCUMENT_ROOT}/%{REQUEST_URI}" !-s - RewriteRule ^/ /masterwebinterface.pl - - ErrorLog /server/MasterServer-Perl/log/MasterWebInterface-Error.log - CustomLog /server/MasterServer-Perl/log/MasterWebInterface-Access.log combined - - - Options +FollowSymLinks +ExecCGI - AllowOverride None - Require all granted - - - -# KNOWN ISSUES - There are a few known issues that will be resolved in future versions. The - following issues are listed and do not need to be reported. - - This README file does not describe all possible configuration options. There - is an initiative to write the webinterface documentation in a single document - that is focused on all options and recommended values. For now, use your best - guess. - - There are no textures, map thumbnails and/or nice steals included in this - repository. All styles, textures, increasingly growing amounts of map thumbs - and game icons are located at another repository on git.333networks.com and - are available for all supported packages. - -# COPYING - See COPYING file +## DESCRIPTION + +This repository contains software for a web interface to display information obtained by the 333networks MasterServer package for the support of various legacy games. The software was written Darkelarious to soften the effects of GameSpy (GameSpy Industries, Inc.) shutting down their masterserver service. + +A masterserver is a program that maintains a list of online game servers and presents this list to clients (gamers, players) who request the list of game addresses. The 333networks Masterserver is a software framework that allows gamers/players to browse online games. + +More information about the masterserver and variations on the protocol by 333networks can be found online at http://333networks.com/masterserver + + +## AUTHOR +Darkelarious +http://333networks.com +darkelarious@333networks.com + +## REQUIREMENTS +* Apache/httpd +* Postgresql, MySQL or SQLite3 +* Perl 5.10 or above +* The following CPAN modules: + * DBI + * DBD::Pg / DBD::SQLite / DBD::mysql + * IP::Country::Fast + * Image::Size + * TUWF (http://dev.yorhel.nl/tuwf) + +## INSTALL +THE MASTER SERVER IS WRITTEN ON LINUX. IF YOU WANT TO RUN THE SOFTWARE IN MICROSOFT WINDOWS OR APPLE OSX, IT MAY NOT WORK WITHOUT MODIFICATIONS. + +This repository consists of Perl modules and is run by a http deamon. First, the MasterServer-Perl repository should be installed and configured in order to run this web interface. The contents of this repository can be extracted in the same root folder as MasterServer-Perl. + +## CONFIGURATION +The 333networks masterserver interface comes with options. These options are found in configuration file "data/webinterface-config.pl". Comments in the file give a brief description. Below, the configuration is discussed in further detail. + +### Database login information + +The masterserver interface supports different database types. This must be the same database (and type) as you specified in your MasterServer-Perl config. + +``` +# postgresql +db_login => ['dbi:Pg:dbname=masterserver', 'user', 'password'], + +# sqlite +db_login => ["dbi:SQLite:dbname=$ROOT/data/masterserver.db",'',''], +``` + +You also need to (un)comment the right database module in the masterwebinterface.pl file to load the correct driver. + +### Apache settings +``` +LoadModule rewrite_module modules/mod_rewrite.so +AddHandler cgi-script .cgi .pl +``` + +Vhost configuration for the Web Interface (assuming you extracted it in the same folder as your MasterServer-Perl installation): + +``` +# +# Master Web Interface +# + +ServerAdmin master@yourdomain.com +ServerName master.yourdomain.com + +DocumentRoot "/server/MasterServer-Perl/s" +AddHandler cgi-script .pl + +RewriteEngine On +RewriteCond "%{DOCUMENT_ROOT}/%{REQUEST_URI}" !-s +RewriteRule ^/ /masterwebinterface.pl + +ErrorLog /server/MasterServer-Perl/log/MasterWebInterface-Error.log +CustomLog /server/MasterServer-Perl/log/MasterWebInterface-Access.log combined + + + Options +FollowSymLinks +ExecCGI + AllowOverride None + Require all granted + + +``` + +## KNOWN ISSUES +There are a few known issues that will be resolved in future versions. The following issues are listed and do not need to be reported. + +This README file does not describe all possible configuration options. There is an initiative to write the webinterface documentation in a single document that is focused on all options and recommended values. For now, use your best guess. + +There are no textures, map thumbnails and/or nice steals included in this repository. All styles, textures, increasingly growing amounts of map thumbs and game icons are located at another repository on code.333networks.com and are available for all supported packages. + +## COPYING +See COPYING file diff --git a/util/masterwebinterface.pl b/util/masterwebinterface.pl index 596c149..10d2b54 100755 --- a/util/masterwebinterface.pl +++ b/util/masterwebinterface.pl @@ -19,7 +19,7 @@ $TUWF::OBJ->{$_} = $S{$_} for (keys %S); TUWF::set( logfile => "$ROOT/log/MasterWebInterface-TUWF.log", mail_from => '', - db_login => ['dbi:Pg:dbname=devmasterserver', 'unrealmaster', 'unrealmasterpassword'], + db_login => ['dbi:Pg:dbname=devmasterserver', 'user', 'pass'], # db_login => ["dbi:SQLite:dbname=$ROOT/data/databasename.db",'',''], validate_templates => { # input templates page => { template => 'uint', max => 1000 }, -- cgit v1.2.3