view release on metacpan or  search on metacpan

README.rst  view on Meta::CPAN

        ** cd Downloads**

Then install the package:

        **sudo yum localinstall perl-Games-Axmud-X.Y.ZZZ.noarch.rpm**

You must replace the **X.Y.ZZZ** with the actual version number you've downloaded, for example:

        **sudo yum localinstall perl-Games-Axmud-1.2.345.noarch.rpm**

When installation is complete, start Axmud by typing:

        **axmud.pl**

5.3 Installation on Linux from source
-------------------------------------

Manual installation is quite simple on most modern Linux systems.

This document contains complete instruction for some of the most popular distros:

- Arch-based systems (such as Arch Linux)
- Debian-based systems (such as Debian, Ubuntu and Linux Mint)
- Fedora
- Manjaro
- openSUSE (see below)
- Red Hat Enterprise Linux and CentOS

Axmud v1.2.0 (and later versions) cannot easily be easily installed on openSUSE, as the required graphics library (Gtk3) is not yet available through openSUSE's software repositories. We suggest that you continue using Axmud v1.1.405 for the time bei...

5.3.1 Installation on Arch-based systems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

(These instructions have been tested on Arch Linux. For Manjaro, see the section below.)

First, download the source code from the Axmud website (the most recent file ending .tar.gz).

Open a terminal window and navigate to the directory containing the downloaded file, for example:

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud-X.Y.ZZZ.tar.gz**
        **cd Games-Axmud-X.Y.ZZZ**

You must replace the **X.Y.ZZZ** with the actual version number you've downloaded, for example:

        **tar -pzxvf Games-Axmud-1.2.345.tar.gz**
        **cd Games-Axmud-1.2.345**

Make sure you have the right dependencies:

        **sudo pacman -S gtk3 perl-gtk3 goocanvas wmctrl**
        **sudo pacman -S perl-cpanplus-dist-arch**
        **setupdistarch**
        **sudo cpanp i Archive::Zip File::Copy::Recursive File::HomeDir File::ShareDir File::ShareDir::Install Glib Gtk3 GooCanvas2 IO::Socket::INET6 IPC::Run JSON Math::Round Net::OpenSSH Path::Tiny Regexp::IPv6**

At the time of writing, there are some issues with installing certain libraries on Arch. If you know that those issues have been fixed, you can type this command to allow Axmud to use SSL connections:

        **sudo cpanp i IO::Socket::SSL**

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo pacman -S sox timidity++ espeak-ng**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

When installation is complete, start Axmud by typing:

        **axmud.pl**

Axmud's default text-to-speech engine is eSpeak but, at the time of writing, there are some issues with its installation on Arch systems. Assuming that an alternative speech engine has been installed using the instructions just above, visually-impair...

        **baxmud.pl esng**

Once Axmud has started, type the following commands, which replace Axmud's default speech engine with espeak-ng:

        **;config all engine esng**
        **;save**

Thereafter, visually-impaired users can start Axmud by typing:

        **baxmud.pl**

5.3.2 Installation on Debian-based systems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

(These instructions have been tested on Debian, Ubuntu and Linux Mint.)

First, download the source code from the Axmud website (the most recent file ending .tar.gz).

Open a terminal window and navigate to the directory containing the downloaded file, for example:

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud\*.tar.gz**

        **cd Games-Axmud**\*

Make sure you have the right dependencies:

        **sudo apt-get update**
        **sudo apt-get install build-essential libgtk3-perl libgoocanvas-2.0-dev wmctrl**
        **sudo cpan install Archive::Extract File::HomeDir File::ShareDir File::ShareDir::Install GooCanvas2 JSON Math::Round Net::OpenSSH Path::Tiny Regexp::IPv6**

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo apt-get install libsox-fmt-all timidity**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

README.rst  view on Meta::CPAN

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud-X.Y.ZZZ.tar.gz**
        **cd Games-Axmud-X.Y.ZZZ**

You must replace the X.Y.ZZZ with the actual version number you've downloaded, for example:

        **tar -pzxvf Games-Axmud-1.2.345.tar.gz**
        **cd Games-Axmud-1.2.345**

Make sure you have the right dependencies:

        **sudo rpm --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro**
        **sudo rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-1.el7.nux.noarch.rpm**
        **sudo dnf install cpan**
        **sudo dnf install 'perl(Archive::Extract)' 'perl(File::Copy::Recursive)' 'perl(File::Fetch)' 'perl(File::HomeDir)' 'perl(File::ShareDir)' 'perl(File::ShareDir::Install)' 'perl(Glib)' 'perl(Gtk3)' 'perl(GooCanvas2)' 'perl(IO::Socket::INET6)' ...

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo dnf install sox timidity++**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

When installation is complete, start Axmud by typing:

        **axmud.pl**

5.3.4 Installation on Manjaro
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Manjaro's rolling release version is affected by a recurring issue (Perl modules are not updated when the Perl itself is updated, meaning that any Perl applications will immediately stop working). If you're using the rolling release
version, consider installing via `Perl homebrew <https://perlbrew.pl/>`__ instead.

These instructions work on both the stable and rolling releases of Manjaro.

First, download the source code from the Axmud website (the most recent file ending .tar.gz).

Open a terminal window and navigate to the directory containing the downloaded file, for example:

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud-X.Y.ZZZ.tar.gz**
        **cd Games-Axmud-X.Y.ZZZ**

You must replace the X.Y.ZZZ with the actual version number you've downloaded, for example:

        **tar -pzxvf Games-Axmud-1.2.345.tar.gz**
        **cd Games-Axmud-1.2.345**

Make sure you have the right dependencies:

        **sudo pacman -S base-devel gtk3 goocanvas perl-gtk3 perl-goocanvas2 wmctrl cpanminus**
        **sudo cpanm Archive::Extract File::Copy::Recursive File::HomeDir File::ShareDir File::ShareDir::Install Glib IO::Socket::INET6 IO::Socket::SSL IPC::Run JSON Math::Round Net::OpenSSH Path::Tiny Regexp::IPv6**
        **sudo cpanm Archive::Zip --force**

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo pacman -S sox timidity++**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

When installation is complete, start Axmud by typing:

        **axmud.pl**

5.3.5 Installation on openSUSE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Axmud v1.2.0 (and later versions) cannot easily be easily installed on openSUSE, as the required graphics library (Gtk3) is not yet available through openSUSE's software repositories. We suggest that you continue using Axmud v1.1.405 for the time bei...

5.3.6 Installation on Red Hat Enterprise Linux / CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First, download the source code from the Axmud website (the most recent file ending .tar.gz).

Open a terminal window and navigate to the directory containing the downloaded file, for example:

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud-X.Y.ZZZ.tar.gz**
        **cd Games-Axmud-X.Y.ZZZ**

You must replace the X.Y.ZZZ with the actual version number you've downloaded, for example:

        **tar -pzxvf Games-Axmud-1.2.345.tar.gz**
        **cd Games-Axmud-1.2.345**

Now we need to add an extra repository. First get the key:

        **sudo rpm --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro**

Then add the repository. On CentOS/RHEL 6, do this:

        **sudo rpm -Uvh http://li.nux.ro/download/nux/dextop/el6/x86_64/nux-dextop-release-0-2.el6.nux.noarch.rpm**

On CentOS/RHEL 7, do this:

        **sudo rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-1.el7.nux.noarch.rpm**

Now make sure you have the right dependencies:

        **sudo yum groupinstall 'Development Tools'**
        **sudo yum install epel-release cpan goocanvas2 wmctrl**
        **sudo yum install 'perl(Archive::Extract)' 'perl(Archive::Tar)' 'perl(Archive::Zip)' 'perl(File::Copy::Recursive)' 'perl(File::Fetch)' 'perl(File::HomeDir)' 'perl(File::ShareDir)' 'perl(File::ShareDir::Install)' 'perl(Glib)' 'perl(Gtk3)' 'pe...
        **sudo cpan install GooCanvas2**

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo yum install sox libtimidity**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

When installation is complete, start Axmud by typing:

        **axmud.pl**

6 Installation ON BSD
=====================

Manual installation using the source code is quite simple on BSD. (At the time of writing, no installer is available).

6.1 Installation on GhostBSD
----------------------------

(These instructions have been tested on GhostBSD, which is based on FreeBSD. It's likely that installation instructions are the same or very similar on all distros based on FreeBSD, OpenBSD or NetBSD.)

Open a terminal window and navigate to the directory containing the downloaded file, for example:

        **cd Downloads**

Decompress the .tar.gz file:

        **tar -pzxvf Games-Axmud-X.Y.ZZZ.tar.gz**
        **cd Games-Axmud-X.Y.ZZZ**

You must replace the X.Y.ZZZ with the actual version number you've downloaded, for example:

        **tar -pzxvf Games-Axmud-1.2.345.tar.gz**
        **cd Games-Axmud-1.2.345**

Make sure you have the right dependencies:

        **sudo pkg install goocanvas2 wmctrl**
        **sudo cpan install Archive::Extract Archive::Zip File::Copy::Recursive File::HomeDir File::ShareDir File::ShareDir::Install Glib Gtk3 GooCanvas2 IO::Socket::INET6 IO::Socket::SSL IPC::Run JSON Math::Round Net::OpenSSH Path::Tiny Regexp::IPv6...

If you want to use sound effects and/or text-to-speech, you should also type:

        **sudo pkg install sox timidity++**

Then install Axmud itself:

        **perl Makefile.PL**
        **make**
        **sudo make install**

When installation is complete, start Axmud by typing:

        **axmud.pl**

7 List of pre-configured worlds
===============================

Axmud can be used with any world that supports telnet, SSH or SSL connections. The following pre-configured worlds have already been set up to use the automapper, handle connections and so on.

- `3-Kingdoms <http://www.3k.org/>`__ (`Mudstats page <http://mudstats.com/World/3-Kingdoms>`__)
- `3-Scapes <http://www.3k.org/about3s.php>`__ (`Mudstats page <http://mudstats.com/World/3Scapes>`__)
- `4Dimensions <http://4dimensions.org/>`__ (`Mudstats page <http://mudstats.com/World/4Dimensions>`__)
- `Aardwolf MUD <http://www.aardwolf.com/>`__ (`Mudstats page <http://mudstats.com/World/AardwolfMUD>`__)
- `Achaea, Dreams of Divine Lands <http://www.achaea.com/>`__ (`Mudstats page <http://mudstats.com/World/Achaea,DreamsofDivineLands>`__)
- `Adventures Unlimited <https://tharel.net/>`__ (`Mudstats page <http://mudstats.com/World/AdventuresUnlimited>`__)
- `Aetolia, the Midnight Age <http://www.aetolia.com/>`__ (`Mudstats page <http://mudstats.com/World/Aetolia,theMidnightAge>`__)
- `Age of Chaos <http://aoc.pandapub.com/>`__ (`Mudstats page <http://mudstats.com/World/AgeofChaos>`__)
- `Alter Aeon <http://alteraeon.com/>`__ (`Mudstats page <http://mudstats.com/World/AlterAeon>`__)
- `Ancient Anguish <http://ancient.anguish.org/>`__ (`Mudstats page <http://mudstats.com/World/AncientAnguish>`__)
- `Archipelago MUD <http://the-firebird.net:8004/>`__
- `ArcticMud <http://arcticmud.org/>`__ (`Mudstats page <http://mudstats.com/World/ArticMUD>`__)
- `Avalon (Germany) <http://avalon.mud.de/>`__ (`Mudstats page <http://mudstats.com/World/Avalon(Germany)>`__)
- `Avalon: The Legend Lives <http://www.avalon-rpg.com/>`__ (`Mudstats page <http://mudstats.com/World/Avalon,TheLegendLives>`__)
- `Avatar MUD <http://www.outland.org/>`__ (`Mudstats page <http://mudstats.com/World/AVATARMud>`__)
- `BatMUD <http://www.bat.org/>`__ (`Mudstats page <http://mudstats.com/World/BatMUD>`__)
- `Bedlam <http://bedlam.mudportal.com/>`__ (`Mudstats page <http://mudstats.com/World/Bedlam>`__)
- `Burning MUD <http://burningmud.com/>`__ (`Mudstats page <http://mudstats.com/World/BurningMUD>`__)
- `Bylins MUD <http://www.bylins.su/>`__
- `CLOK <http://wiki.contrarium.net/index.php?title=Main_Page>`__ (`Mudstats page <http://mudstats.com/World/CLOK>`__)
- `Carrion Fields <http://www.carrionfields.net/>`__ (`Mudstats page <http://mudstats.com/World/CarrionFields>`__)
- `Clessidra MUD <http://www.clessidra.it/>`__ (`Top Mud Sites page <http://www.topmudsites.com/forums/muddisplay.php?s=97c4b801dd5c8dc5fc88f00334c3a3eb&amp;mudid=jokerclex>`__)
- `CoffeeMud <coffeemud.net>`__ (`Mudstats page <http://mudstats.com/World/BLANK>`__)
- `Cryosphere <http://cryosphere.net/>`__ (`Mudstats page <http://mudstats.com/World/Cryosphere>`__)
- `CyberASSAULT <http://www.cyberassault.org/>`__ (`Mudstats page <http://mudstats.com/World/CyberASSAULT>`__)
- `Dark Realms: City of Syne <http://darkrealmscos.com/>`__
- `Dark and Shattered Lands <http://www.dsl-mud.org/>`__ (`Mudstats page <http://mudstats.com/World/DarkandShatteredLands>`__)
- `DartMUD <http://dartmud.com>`__ (`Mudstats page <http://mudstats.com/World/Dartmud>`__)
- `Dawn <http://dawnmud.com/>`__ (`Mudstats page <http://mudstats.com/World/Dawn>`__)
- `Dead Souls Dev <http://dead-souls.net/>`__ (`Mudstats page <http://mudstats.com/World/DeadSoulsPrime>`__)
- `Dead Souls Local <http://dead-souls.net/>`__ (`Mudstats page <http://mudstats.com/World/DeadSoulsPrime>`__)
- `Dead Souls Prime <http://dead-souls.net/>`__ (`Mudstats page <http://mudstats.com/World/DeadSoulsPrime>`__)
- `Discworld MUD <http://discworld.starturtle.net/lpc/>`__ (`Mudstats page <http://mudstats.com/World/DiscworldMUD>`__)
- `Dragon Swords <http://www.dragonswordsmud.com/>`__ (`Mudstats page <http://mudstats.com/World/DragonSwordsMUD>`__)
- `DragonStone <http://www.garbledtransmissions.com/dragonstone>`__ (`Mudstats page <http://mudstats.com/World/DragonStone>`__)
- `DuneMUD <http://www.dunemud.com/>`__ (`Mudstats page <http://mudstats.com/World/DuneMUD>`__)
- `Duris: Land of BloodLust <http://www.durismud.com/>`__ (`Mudstats page <http://mudstats.com/World/DurisLandofBloodLust>`__)
- `Elephant MUD <http://www.elephant.org/>`__ (`Mudstats page <http://mudstats.com/World/ElephantMud>`__)
- `Elysium RPG <http://www.elysium-rpg.com/wiki/Main_Page>`__ (`Top Mud Sites page <http://www.topmudsites.com/forums/muddisplay.php?mudid=elysium>`__)
- `EmpireMUD 2.0 <https://empiremud.net/>`__ (`Mudstats page <http://mudstats.com/World/EmpireMUD20>`__)