add registration WIP

.env

@@ -0,0 +1,8 @@
+MYSQL_SUPERPASS="root00"
+
+MANGOS_DBUSER="mangos"
+MANGOS_DBPASS="mangos00"
+
+WOW_CLIENT_DIR="/chemin/vers/WOTLK/"
+WOW_TIMEZONE="Europe/Paris"
+WOW_VERSION="wotlk"

.gitignore

@@ -0,0 +1,3 @@
+cmangos-docker.wiki
+mangosd_data/*
+database_data/*

LICENSE

@@ -0,0 +1,661 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+   Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+        Preamble
+
+The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate.  Many developers of free software are heartened and
+encouraged by the resulting cooperation.  However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community.  It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server.  Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals.  This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+The precise terms and conditions for copying, distribution and
+modification follow.
+
+   TERMS AND CONDITIONS
+
+0. Definitions.
+
+"This License" refers to version 3 of the GNU Affero General Public License.
+
+"Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+"The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+1. Source Code.
+
+The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+The Corresponding Source for a work in source code form is that
+same work.
+
+2. Basic Permissions.
+
+All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+4. Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+5. Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+a) The work must carry prominent notices stating that you modified
+it, and giving a relevant date.
+
+b) The work must carry prominent notices stating that it is
+released under this License and any conditions added under section
+7.  This requirement modifies the requirement in section 4 to
+"keep intact all notices".
+
+c) You must license the entire work, as a whole, under this
+License to anyone who comes into possession of a copy.  This
+License will therefore apply, along with any applicable section 7
+additional terms, to the whole of the work, and all its parts,
+regardless of how they are packaged.  This License gives no
+permission to license the work in any other way, but it does not
+invalidate such permission if you have separately received it.
+
+d) If the work has interactive user interfaces, each must display
+Appropriate Legal Notices; however, if the Program has interactive
+interfaces that do not display Appropriate Legal Notices, your
+work need not make them do so.
+
+A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+6. Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+a) Convey the object code in, or embodied in, a physical product
+(including a physical distribution medium), accompanied by the
+Corresponding Source fixed on a durable physical medium
+customarily used for software interchange.
+
+b) Convey the object code in, or embodied in, a physical product
+(including a physical distribution medium), accompanied by a
+written offer, valid for at least three years and valid for as
+long as you offer spare parts or customer support for that product
+model, to give anyone who possesses the object code either (1) a
+copy of the Corresponding Source for all the software in the
+product that is covered by this License, on a durable physical
+medium customarily used for software interchange, for a price no
+more than your reasonable cost of physically performing this
+conveying of source, or (2) access to copy the
+Corresponding Source from a network server at no charge.
+
+c) Convey individual copies of the object code with a copy of the
+written offer to provide the Corresponding Source.  This
+alternative is allowed only occasionally and noncommercially, and
+only if you received the object code with such an offer, in accord
+with subsection 6b.
+
+d) Convey the object code by offering access from a designated
+place (gratis or for a charge), and offer equivalent access to the
+Corresponding Source in the same way through the same place at no
+further charge.  You need not require recipients to copy the
+Corresponding Source along with the object code.  If the place to
+copy the object code is a network server, the Corresponding Source
+may be on a different server (operated by you or a third party)
+that supports equivalent copying facilities, provided you maintain
+clear directions next to the object code saying where to find the
+Corresponding Source.  Regardless of what server hosts the
+Corresponding Source, you remain obligated to ensure that it is
+available for as long as needed to satisfy these requirements.
+
+e) Convey the object code using peer-to-peer transmission, provided
+you inform other peers where the object code and Corresponding
+Source of the work are being offered to the general public at no
+charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+"Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+7. Additional Terms.
+
+"Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+a) Disclaiming warranty or limiting liability differently from the
+terms of sections 15 and 16 of this License; or
+
+b) Requiring preservation of specified reasonable legal notices or
+author attributions in that material or in the Appropriate Legal
+Notices displayed by works containing it; or
+
+c) Prohibiting misrepresentation of the origin of that material, or
+requiring that modified versions of such material be marked in
+reasonable ways as different from the original version; or
+
+d) Limiting the use for publicity purposes of names of licensors or
+authors of the material; or
+
+e) Declining to grant rights under trademark law for use of some
+trade names, trademarks, or service marks; or
+
+f) Requiring indemnification of licensors and authors of that
+material by anyone who conveys the material (or modified versions of
+it) with contractual assumptions of liability to the recipient, for
+any liability that these contractual assumptions directly impose on
+those licensors and authors.
+
+All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+8. Termination.
+
+You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+9. Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+10. Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+11. Patents.
+
+A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+12. No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+13. Remote Network Interaction; Use with the GNU General Public License.
+
+Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your version
+supports such interaction) an opportunity to receive the Corresponding
+Source of your version by providing access to the Corresponding Source
+from a network server at no charge, through some standard or customary
+means of facilitating copying of software.  This Corresponding Source
+shall include the Corresponding Source for any work covered by version 3
+of the GNU General Public License that is incorporated pursuant to the
+following paragraph.
+
+Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+14. Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions of
+the GNU Affero General Public License from time to time.  Such new versions
+will be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future
+versions of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+15. Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+17. Interpretation of Sections 15 and 16.
+
+If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+<one line to give the program's name and a brief idea of what it does.>
+Copyright (C) <year>  <name of author>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source.  For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code.  There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for the
+specific requirements.
+
+You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU AGPL, see
+<http://www.gnu.org/licenses/>.

README.md

@@ -1,113 +1,80 @@
-# WORLD OF WARCRAFT SERVER INSTALL (VERSION 1.12)
+# wow private server
 
-## PRE REQUIS
+Déployer un serveur privé pour World Of Warcrfat via [cmangos](https://cmangos.net) compatible versions Classic (1.12.x), Burning Crusade (2.4.3) et Wrath Of The Litch King (3.3.5a)
 
-- debian 12
+## Pre requis
-- user wow
-- ports:
-  - TCP: 1119, 3724, 6012, 8085
-  - UDP: 1119, 3724, 6012, 8085
 
-- WOW 1.12 client: https://drive.usercontent.google.com/download?id=1TDoNNUXCtsgIUhLw96biPCqjv3AcLYkg&export=download
+- Linux 🐧
+- Docker :whale:
+- Clients:
 
-## CREER UN UTILISATEURS
+## Versions prises en charge
 
-Lancer le service mangosd:
+|                  Game name                 | Game version |  Keyword  |  client download  |
+|--------------------------------------------|--------------|-----------|-------------------|
+|             World of Warcraft®             |  **v1.12.x** | `classic` | https://archive.org/download/World_of_Warcraft_Client_and_Installation_Archive/ISO/WoW-1.12.1_install.rar |
+|   World of Warcraft: The Burning Crusade®  |  **v2.4.3**  |   `tbc`   | https://archive.org/download/World_of_Warcraft_Client_and_Installation_Archive/ISO/WoW-2.4.3_install.rar |
+| World of Warcraft: Wrath of the Link King® |  **v3.3.5a** |  `wotlk`  | somewher in the web ;) |
+
+
+## Configuration
+
+- Renseigner dans le fichier `.env` :
+    - Le chemin absolue vers le client WOW (Classic, tbc ou wotlk)
+    - La version de WOW correspondante au client ()
+    - La TimeZone (TZ)
+    - Mots de passe database
+
+## Installation
+
+### Extraire les maps du client 
 ```bash
-cd /home/$CURRENT_USER/vmangos/bin/
+./docker/run.sh extract
-sudo ./mangosd
 ```
 
-- Créer un utilisateur:
+> Choisir l'import en HD avec le plus de CPU possible car c'est long ☕
+
+### Builder les images
+
 ```bash
-account create <username> <password>
+./build_docker_image.sh wotlk 2
+#                    version / nb threads
 ```
 
-[autres commandes](https://github.com/dkpminus/mangos-gm-commands)
+> L'image builder récupère le code source de cmangos pour le compiler, c'est long aussi ☕
 
-## CRÉER DES SERVICES POUR LANCER LE SERVEUR
+### Peupler la base de données
 
-Fichiers service à créer dans `/etc/systemd/system/`
+- Lançer la base de données:
-
-- Realmd service:
 ```bash
-[Unit]
+docker compose up database
-Description=VMaNGOS Realmd Service
-After=network.target mariadb.service
-
-[Service]
-Type=simple
-User=wow              # <- ton utilisateur normal (pas root)
-WorkingDirectory=/home/wow/vmangos/bin
-ExecStart=/home/wow/vmangos/bin/realmd
-Restart=always
-
-[Install]
-WantedBy=multi-user.target
 ```
 
-- Mangosd service:
+> Laisser tourner et ouvrir un autre terminal
+
+- Dans un autre terminal, lançer le script d'import des données du jeu:
 ```bash
-[Unit]
+./docker/run.sh init-db
-Description=VMaNGOS World Server
-After=network.target mariadb.service realmd.service
-
-[Service]
-Type=simple
-User=wow              # <- ton utilisateur normal
-WorkingDirectory=/home/wow/vmangos/bin
-ExecStart=/home/wow/vmangos/bin/mangosd
-Restart=always
-
-[Install]
-WantedBy=multi-user.target
 ```
 
-## PROTEGER LE SERVEUR VIA FAIL2BAN
+> Patienter le temps de la mise en place de la base de données ☕
+
+### Création du Realm
 
-- Installer fail2ban:
 ```bash
-sudo apt install fail2ban -y
+docker exec  <wow-mangosd> 
+
+# delete realm par défaut
+DELETE FROM realmlist WHERE id = 1;
+# Créer son realm
+INSERT INTO realmlist (id, name, address, port, icon, realmflags, timezone, allowedSecurityLevel)
+    VALUES ('1', 'NOM', '127.0.0.1', '8085', '1', '0', '1', '0');
 ```
 
-- Créer `/etc/fail2ban/filter.d/realmd.conf`:
+> Modifier le `NOM`, l'adresse `IP` du serveur (sauf si sur la même machine que le client) et la timezone si différent de Paris
-```conf
-[Definition]
-failregex = \[AuthChallenge\] Account '.*' using IP '<HOST>' tried to login with wrong password!
-ignoreregex =
-```
 
-- Créer `/etc/fail2ban/jail.local`:
+### TO DO 
-
-```conf
-[realmd]
-enabled  = true
-filter   = realmd
-port     = 3724
-protocol = tcp
-logpath  = /home/wow/vmangos/logs/realmd/realmd.log
-maxretry = 5
-findtime = 600
-bantime  = 36000
-```
-
-- Redémarrer fail2ban:
-```bash
-sudo systemctl restart fail2ban
-sudo fail2ban-client reload
-```
-
-## SE CONNECTER AU SERVEUR
-
-- Télécharger le [client (v1.12)](https://drive.usercontent.google.com/download?id=1TDoNNUXCtsgIUhLw96biPCqjv3AcLYkg&export=download)
-
-- Editer le fichier `realmlist.wtf` pour y mettre l'IP du serveur:
-```bash
-set <server_ip>
-```
-
-## SOURCES
-
-- [vmangos](https://github.com/vmangos)
-- [tuto](https://www.youtube.com/watch?v=ac1mVFz2u1o)
 
+- admin create account OK, change password KO (old password decryption)
+- make registration get vars from .env
+- script install ask version and client path and do all

build_docker_images.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+source ".env"
+
+# Arguments
+THREADS="${1:-2}"
+
+# Infos git
+MANGOS_SHA1=$(curl -sSL "https://api.github.com/repos/cmangos/mangos-${WOW_VERSION}/commits/master" | jq -r .sha)
+DATABASE_SHA1=$(curl -sSL "https://api.github.com/repos/cmangos/${WOW_VERSION}-db/commits/master" | jq -r .sha)
+
+VERSION="1.0.0-$(date -u +"%Y%m%d")"
+DOCKER_IMAGE="wow-server"
+
+# Tags pour builder
+BUILDER_IMAGE_TAG="${DOCKER_IMAGE}-${WOW_VERSION}:builder"
+# Tags pour runner
+RUNNER_IMAGE_TAG="${DOCKER_IMAGE}-${WOW_VERSION}:runner"
+
+echo "==== Build de l’image BUILDER ===="
+docker buildx build \
+  --build-arg EXPANSION="${WOW_VERSION}" \
+  --build-arg MANGOS_SHA1="${MANGOS_SHA1}" \
+  --build-arg DATABASE_SHA1="${DATABASE_SHA1}" \
+  --build-arg THREADS="${THREADS}" \
+  --build-arg VERSION="${VERSION}" \
+  --target builder \
+  --tag "${BUILDER_IMAGE_TAG}" \
+  --load \
+  docker/
+
+echo "==== Build de l’image RUNNER ===="
+docker buildx build \
+  --build-arg EXPANSION="${WOW_VERSION}" \
+  --build-arg MANGOS_SHA1="${MANGOS_SHA1}" \
+  --build-arg DATABASE_SHA1="${DATABASE_SHA1}" \
+  --build-arg THREADS="${THREADS}" \
+  --build-arg VERSION="${VERSION}" \
+  --target runner \
+  --tag "${RUNNER_IMAGE_TAG}" \
+  --load \
+  docker/
+
+echo "==== Images construites ===="
+docker images | grep "${DOCKER_IMAGE}"

compose.yml

@@ -0,0 +1,97 @@
+services:
+  database:
+    image: mariadb:11.8
+    container_name: wow-db
+    environment:
+      MARIADB_ROOT_PASSWORD: "${MYSQL_SUPERPASS}"      
+    volumes:
+      - ./database_data:/var/lib/mysql
+      - ./config/database:/etc/mysql/conf.d:ro
+    networks:
+      - wow
+
+  mangosd:
+    image: wow-server-${WOW_VERSION}:runner
+    container_name: wow-mangosd
+    depends_on:
+      - database
+    environment:
+      MANGOS_DBHOST: database
+      MANGOS_DBUSER: "${MANGOS_DBUSER}"
+      MANGOS_DBPASS: "${MANGOS_DBPASS}"
+      TZ: "${WOW_TIMEZONE}"
+    command: mangosd
+    stdin_open: true
+    tty: true
+    ports:
+      - "${MANGOSD_PORT:-8085}:8085"
+      - "7878:7878"
+    volumes:
+      - ./mangosd_data:/var/lib/mangos:ro
+      - ./config/mangosd:/opt/mangos/conf:ro
+    networks:
+      - wow
+
+  realmd:
+    image: wow-server-${WOW_VERSION}:runner
+    container_name: wow-realmd
+    depends_on:
+      - database
+    environment:
+      MANGOS_DBHOST: database
+      MANGOS_DBUSER: "${MANGOS_DBUSER}"
+      MANGOS_DBPASS: "${MANGOS_DBPASS}"
+      TZ: "${WOW_TIMEZONE}"
+    command: realmd
+    ports:
+      - "${REALMD_PORT:-3724}:3724"
+    volumes:
+      - ./mangosd_data:/var/lib/mangos:ro
+      - ./config/realmd:/opt/mangos/conf:ro
+    networks:
+      - wow
+
+  phpmyadmin:
+    image: phpmyadmin:5.2
+    container_name: wow-db-admin
+    depends_on:
+      - database
+    profiles:
+      - debug
+    environment:
+      PMA_HOST: database
+      PMA_USER: root
+      PMA_PASSWORD: "${MYSQL_SUPERPASS}"
+    networks:
+      - wow
+    ports:
+      - "${PHPMYADMIN_PORT:-8080}:80"
+
+  # admin:
+  #   build: ./php
+  #   ports:
+  #     - "8089:80"
+  #   env_file:
+  #     - .env
+  #   depends_on:
+  #     - database
+  #   networks:
+  #     - wow
+
+  php-panel:
+    image: wow-registration
+#    build: ./registration
+    container_name: wow-registration
+    ports:
+      - "8090:80"
+    environment:
+      - SOAP_HOST=mangosd
+      - SOAP_PORT=7878
+    depends_on:
+      - mangosd
+    networks:
+      - wow
+
+networks:
+  wow:
+    driver: bridge

config/database/my.cnf

@@ -0,0 +1,2 @@
+[mysqld]
+wait_timeout = 28800

config/realmd/realmd.conf

@@ -0,0 +1,149 @@
+############################################
+# MaNGOS realmd configuration file
+#
+# 	To overwrite configuration fields with environment variables
+# 	use the following pattern to generate environment variable names:
+#
+# 		For WrongPass.MaxCount:
+# 			export Realmd_WrongPass_MaxCount=10
+#
+# 		For RealmServerPort:
+# 			export Realmd_RealmServerPort=3333
+#
+############################################
+
+[RealmdConf]
+ConfVersion=2021031501
+
+###################################################################################################################
+# REALMD SETTINGS
+#
+#    LoginDatabaseInfo
+#        Database connection settings for the realm server.
+#        Default: hostname;port;username;password;database
+#                 .;somenumber;username;password;database - use named pipes at Windows
+#                       Named pipes: mySQL required adding "enable-named-pipe" to [mysqld] section my.ini
+#                 .;/path/to/unix_socket;username;password;database - use Unix sockets at Unix/Linux
+#                       Unix sockets: experimental, not tested
+#
+#    LogsDir
+#         Logs directory setting.
+#         Important: Logs dir must exists, or all logs be disable
+#         Default: "" - no log directory prefix. if used log names aren't absolute paths
+#                       then logs will be stored in the current directory of the running program.
+#
+#    MaxPingTime
+#         Settings for maximum database-ping interval (minutes between pings)
+#
+#    RealmServerPort
+#         Port on which the server will listen
+#
+#    BindIP
+#         Bind Realm Server to specific IP address
+#         This option is useful for running multiple worldd/realmd instances
+#         on different IP addresses using default ports.
+#         DO NOT CHANGE THIS UNLESS YOU _REALLY_ KNOW WHAT YOU'RE DOING
+#
+#    ListenerThreads
+#        Number of listener threads realmd should use.
+#        Default: 1
+#
+#    PidFile
+#        Realmd daemon PID file
+#        Default: ""             - do not create PID file
+#                 "./realmd.pid" - create PID file (recommended name)
+#
+#    LogLevel
+#        Server console level of logging
+#        0 = Minimum; 1 = Error; 2 = Detail; 3 = Full/Debug
+#        Default: 0
+#
+#    LogTime
+#        Include time in server console output [hh:mm:ss]
+#        Default: 0 (no time)
+#                 1 (print time)
+#
+#    LogFile
+#        Logfile name
+#        Default: "Realmd.log"
+#                 "" - empty name disable creating log file
+#
+#    LogTimestamp
+#        Logfile with timestamp of server start in name
+#        Default: 0 - no timestamp in name
+#                 1 - add timestamp in name in form Logname_YYYY-MM-DD_HH-MM-SS.Ext for Logname.Ext
+#
+#    LogFileLevel
+#        Server file level of logging
+#        0 = Minimum; 1 = Error; 2 = Detail; 3 = Full/Debug
+#        Default: 0
+#
+#    LogColors
+#        Color for messages (format "normal_color details_color debug_color error_color)
+#        Colors: 0 - BLACK, 1 - RED, 2 - GREEN,  3 - BROWN, 4 - BLUE, 5 - MAGENTA, 6 -  CYAN, 7 - GREY,
+#                8 - YELLOW, 9 - LRED, 10 - LGREEN, 11 - LBLUE, 12 - LMAGENTA, 13 - LCYAN, 14 - WHITE
+#        Default: "" - none colors
+#                 "13 7 11 9" - for example :)
+#
+#    UseProcessors
+#        Used processors mask for multi-processors system (Used only at Windows)
+#        Default: 0 (selected by OS)
+#                 number (bitmask value of selected processors)
+#
+#    ProcessPriority
+#        Process proirity setting (Used only at Windows)
+#        Default: 1 (HIGH)
+#                 0 (Normal)
+#
+#    WaitAtStartupError
+#        After startup error report wait <Enter> or some time before continue (and possible close console window)
+#                 -1 (wait until <Enter> press)
+#        Default:  0 (not wait)
+#                  N (>0, wait N secs)
+#
+#    RealmsStateUpdateDelay
+#        Realm list Update up delay (updated at realm list request if delay expired).
+#        Default: 20
+#                 0  (Disabled)
+#
+#    StrictVersionCheck
+#        Description: Prevent modified clients from connnecting
+#        Default:     0 - (Disabled)
+#                     1 - (Enabled)
+#
+#    WrongPass.MaxCount
+#        Number of login attemps with wrong password before the account or IP is banned
+#        Default: 0  (Never ban)
+#
+#    WrongPass.BanTime
+#        Duration of the ban in seconds (0 means permanent ban)
+#        Default: 600
+#
+#    WrongPass.BanType
+#        Ban the IP or account on which login is attempted
+#        Default: 0 (Ban IP)
+#                 1 (Ban Account)
+#
+###################################################################################################################
+
+# LoginDatabaseInfo = "127.0.0.1;3306;mangos;mangos;classicrealmd"
+# LogsDir = ""
+MaxPingTime = 30
+RealmServerPort = 3724
+BindIP = "0.0.0.0"
+ListenerThreads = 1
+PidFile = ""
+LogLevel = 0
+LogTime = 0
+LogFile = "Realmd.log"
+LogTimestamp = 0
+LogFileLevel = 0
+LogColors = ""
+UseProcessors = 0
+ProcessPriority = 1
+WaitAtStartupError = 0
+RealmsStateUpdateDelay = 20
+StrictVersionCheck = 0
+WrongPass.MaxCount = 0
+WrongPass.BanTime = 600
+WrongPass.BanType = 0

create_user.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+curl -s -u "soapuser:soappass" \
+  -H "Content-Type: text/xml" \
+  -d '<?xml version="1.0" encoding="UTF-8"?>
+  <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
+                     xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
+                     xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
+                     xmlns:xsd="http://www.w3.org/1999/XMLSchema"
+                     xmlns:ns1="urn:MaNGOS">
+    <SOAP-ENV:Body>
+      <ns1:command>account create test2 testpass</ns1:command>
+    </SOAP-ENV:Body>
+  </SOAP-ENV:Envelope>' \
+  http://localhost:7878/

docker/Dockerfile

@@ -0,0 +1,220 @@
+FROM ubuntu:24.04 AS builder
+
+ENV DEBIAN_FRONTEND="noninteractive"
+
+ARG TIMEZONE="Etc/UTC"
+ENV TZ="${TIMEZONE}"
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \
+    \
+    apt-get update \
+ && apt-get install -y --no-install-recommends \
+        tzdata \
+ && ln -snf "/usr/share/zoneinfo/${TIMEZONE}" /etc/localtime \
+ && echo "${TIMEZONE}" > /etc/timezone \
+ && dpkg-reconfigure --frontend noninteractive tzdata \
+ \
+ && apt-get install -y --no-install-recommends \
+        build-essential \
+        ca-certificates \
+        cmake \
+        g++-14 \
+        git-core \
+        libboost-filesystem-dev \
+        libboost-program-options-dev \
+        libboost-regex-dev \
+        libboost-serialization-dev \
+        libboost-system-dev \
+        libboost-thread-dev \
+        libmariadb-dev-compat \
+        libssl-dev \
+        mariadb-client \
+ \
+ && update-alternatives --install /usr/bin/gcc gcc \
+                                  /usr/bin/gcc-14 14 \
+                        --slave /usr/bin/g++ g++ \
+                                /usr/bin/g++-14 \
+ \
+ && rm -rf /tmp/*
+
+ARG EXPANSION
+ARG MANGOS_SHA1="latest"
+ARG DATABASE_SHA1="latest"
+ENV HOME_DIR="/home/mangos"
+ENV MANGOS_DIR="${HOME_DIR}/mangos"
+ENV DATABASE_DIR="${HOME_DIR}/${EXPANSION}-db"
+
+RUN mkdir -p "${MANGOS_DIR}" \
+             "${DATABASE_DIR}" \
+ \
+ && cd /tmp \
+ && if [ "${MANGOS_SHA1}" = "latest" ]; \
+    then \
+        git clone "https://github.com/cmangos/mangos-${EXPANSION}.git" \
+                --branch "master" \
+                --single-branch \
+                --depth 1 \
+           "${MANGOS_DIR}"; \
+    else \
+        git clone "https://github.com/cmangos/mangos-${EXPANSION}.git" \
+                --branch "master" \
+                --single-branch \
+            cmangos-mangos \
+     && cd cmangos-mangos \
+     && git archive "${MANGOS_SHA1}" | tar xC "${MANGOS_DIR}"; \
+    fi \
+ \
+ && cd /tmp \
+ && if [ "${DATABASE_SHA1}" = "latest" ]; \
+    then \
+        git clone "https://github.com/cmangos/${EXPANSION}-db.git" \
+                --branch "master" \
+                --single-branch \
+                --depth 1 \
+            "${DATABASE_DIR}"; \
+    else \
+        git clone "https://github.com/cmangos/${EXPANSION}-db.git" \
+                --branch "master" \
+                --single-branch \
+            cmangos-db \
+     && cd cmangos-db \
+     && git archive "${DATABASE_SHA1}" | tar xC "${DATABASE_DIR}"; \
+    fi \
+ \
+ && rm -rf /tmp/*
+
+# TODO: Add here as building arguments all `cmake` parameters.
+#   - CMAKE_INSTALL_PREFIX    Path where the server should be installed to
+#   - PCH                     Use precompiled headers
+#   - DEBUG                   Include additional debug-code in core
+#   - WARNINGS                Show all warnings during compile
+#   - POSTGRESQL              Use PostgreSQL instead of mysql
+#   - BUILD_EXTRACTORS        Build map/dbc/vmap/mmap extractor
+#   - BUILD_SCRIPTDEV         Build scriptdev. (Disable it to speedup build in dev mode by not including scripts)
+#   - BUILD_PLAYERBOTS        Build Playerbot mod
+#   - BUILD_AHBOT             Build Auction House Bot mod
+#   - BUILD_METRICS           Build Metrics, generate data for Grafana
+#   - BUILD_RECASTDEMOMOD     Build map/vmap/mmap viewer
+#   - BUILD_GIT_ID            Build git_id
+#   - BUILD_DOCS              Build documentation with doxygen
+#
+ARG THREADS="1"
+RUN mkdir -p "${HOME_DIR}/build" \
+             "${HOME_DIR}/run" \
+ \
+ && cd "${HOME_DIR}/build" \
+ && cmake ../mangos/ \
+        -D CMAKE_INSTALL_PREFIX=../run \
+        -D PCH=1 \
+        -D DEBUG=0 \
+        -D BUILD_EXTRACTORS=ON \
+ && make -j "${THREADS}" \
+ && make install \
+ \
+ && cd "${HOME_DIR}/run/bin/tools" \
+ && chmod +x ExtractResources.sh \
+             MoveMapGen.sh
+
+RUN useradd --comment "MaNGOS" \
+            --home "${HOME_DIR}" \
+            --user-group mangos
+
+WORKDIR "${HOME_DIR}"
+
+ENV MYSQL_SUPERUSER="root"
+ENV MYSQL_SUPERPASS=""
+
+ENV MANGOS_DBHOST="host.docker.internal"
+ENV MANGOS_DBPORT="3306"
+ENV MANGOS_DBUSER="mangos"
+ENV MANGOS_DBPASS=""
+
+ENV MANGOS_WORLD_DBNAME="${EXPANSION}mangos"
+ENV MANGOS_CHARACTERS_DBNAME="${EXPANSION}characters"
+ENV MANGOS_LOGS_DBNAME="${EXPANSION}logs"
+ENV MANGOS_REALMD_DBNAME="${EXPANSION}realmd"
+
+COPY entrypoint-builder.sh /entrypoint.sh
+COPY InstallFullDB.config "${DATABASE_DIR}/"
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["bash"]
+
+ENV VOLUME_DIR="/home/mangos/data"
+ENV TMPDIR="${VOLUME_DIR}/tmp"
+VOLUME ["${VOLUME_DIR}"]
+
+
+FROM ubuntu:24.04 AS runner
+
+ENV DEBIAN_FRONTEND="noninteractive"
+
+ARG TIMEZONE="Etc/UTC"
+ENV TZ="${TIMEZONE}"
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \
+    \
+    apt-get update \
+ && apt-get install -y --no-install-recommends \
+        tzdata \
+ && ln -snf "/usr/share/zoneinfo/${TIMEZONE}" /etc/localtime \
+ && echo "${TIMEZONE}" > /etc/timezone \
+ && dpkg-reconfigure --frontend noninteractive tzdata \
+ \
+ && apt-get install -y --no-install-recommends \
+        gosu \
+        libmariadb-dev \
+        libssl3 \
+        wait-for-it \
+        screen \
+ \
+ && rm -rf /tmp/*
+
+ENV HOME_DIR="/home/mangos"
+ENV MANGOS_DIR="/opt/mangos"
+RUN useradd --home "${HOME_DIR}" --create-home \
+            --comment "MaNGOS" \
+            --user-group mangos
+
+WORKDIR "${MANGOS_DIR}"
+
+ARG EXPANSION
+COPY --from=builder "${HOME_DIR}/run" "${MANGOS_DIR}"
+COPY entrypoint-runner.sh /entrypoint.sh
+
+ENV VOLUME_DIR="/var/lib/mangos"
+ENV TMPDIR="${VOLUME_DIR}/tmp"
+RUN mkdir "${VOLUME_DIR}" \
+ && sed -i '/^DataDir/c\DataDir = "'"${VOLUME_DIR}"'"' etc/mangosd.conf.dist
+
+ENV MANGOS_DBHOST="host.docker.internal"
+ENV MANGOS_DBPORT="3306"
+ENV MANGOS_DBUSER="mangos"
+ENV MANGOS_DBPASS=""
+
+ENV MANGOS_WORLD_DBNAME="${EXPANSION}mangos"
+ENV MANGOS_CHARACTERS_DBNAME="${EXPANSION}characters"
+ENV MANGOS_LOGS_DBNAME="${EXPANSION}logs"
+ENV MANGOS_REALMD_DBNAME="${EXPANSION}realmd"
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["bash"]
+
+EXPOSE 3443 3724 7878 8085 8086
+VOLUME ["${VOLUME_DIR}"]
+
+ARG VERSION
+LABEL org.opencontainers.image.title="CMaNGOS Runner \"${EXPANSION}\" version"
+LABEL org.opencontainers.image.description="A CMaNGOS \"${EXPANSION}\" version Docker image ready-to-use to host your emulated private server for WoW wherever you want."
+LABEL org.opencontainers.image.licenses="GPL-2.0"
+LABEL org.opencontainers.image.version="${VERSION}"
+
+ARG MANGOS_SHA1
+LABEL "net.cmangos.mangos-${EXPANSION}.revision"="${MANGOS_SHA1}"
+LABEL "net.cmangos.mangos-${EXPANSION}.source"="https://github.com/cmangos/mangos-${EXPANSION}"
+LABEL "net.cmangos.mangos-${EXPANSION}.url"="https://github.com/cmangos/mangos-${EXPANSION}"
+
+ARG DATABASE_SHA1
+LABEL "net.cmangos.${EXPANSION}-db.revision"="${DATABASE_SHA1}"
+LABEL "net.cmangos.${EXPANSION}-db.source"="https://github.com/cmangos/${EXPANSION}-db"
+LABEL "net.cmangos.${EXPANSION}-db.url"="https://github.com/cmangos/${EXPANSION}-db"

docker/InstallFullDB.config

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+#
+
+####################################################################################################
+# This is the config file for the 'InstallFullDB.sh' script
+#
+# You need to customize
+# MYSQL_HOST: Host on which the database resides
+# MYSQL_PORT: Port on which the database is running
+# MYSQL_USERNAME: Your a valid mysql username
+# MYSQL_PASSWORD: Your corresponding mysql password
+# MYSQL_PATH: Your mysql command (usually mysql)
+# WORLD_DB_NAME: Your content database
+# CORE_PATH: Your path to core's directory
+#
+####################################################################################################
+
+## Define the host on which the mangos database resides (typically localhost)
+MYSQL_HOST="${MANGOS_DBHOST}"
+
+## Define the port on which the mangos database is running (typically 3306)
+MYSQL_PORT="${MANGOS_DBPORT}"
+
+## Define your username
+MYSQL_USERNAME="${MANGOS_DBUSER}"
+
+## Define your password (It is suggested to restrict read access to this file!)
+MYSQL_PASSWORD="${MANGOS_DBPASS}"
+
+## Define default mysql address binding(you can set "%" to be able to connect from any computer)
+MYSQL_USERIP="%"
+
+## Define the databases names (let them empty for default name '<expansion><dbtype>')
+WORLD_DB_NAME="${MANGOS_WORLD_DBNAME}"
+REALM_DB_NAME="${MANGOS_REALMD_DBNAME}"
+CHAR_DB_NAME="${MANGOS_CHARACTERS_DBNAME}"
+LOGS_DB_NAME="${MANGOS_LOGS_DBNAME}"
+
+## Define your mysql programm if this differs
+MYSQL_PATH="/usr/bin/mariadb"
+
+## Define the path to your mysql dump binary folder
+MYSQL_DUMP_PATH="/usr/bin/mariadb-dump"
+
+## Define the path to your core's folder
+CORE_PATH="${MANGOS_DIR}"
+
+## Define if the 'locales' directory for processing localization/multi-language SQL files needs to be used
+## Set the variable to "YES" to use the locales directory
+LOCALES="YES"
+
+## Define if you want to wait a bit before applying the full database
+FORCE_WAIT="NO"
+
+## Define if the 'dev' directory for processing development SQL files needs to be used
+## Set the variable to "YES" to use the dev directory
+DEV_UPDATES="NO"
+
+## Define if AHBot SQL updates need to be applied (by default, assume the core is built without AHBot)
+## Set the variable to "YES" to import AHBot sql.
+AHBOT="NO"
+
+## Define if the 'src/modules/PlayerBots/sql' directory for processing development SQL files needs to be used
+## Set the variable to "YES" to use the playerbots directory
+PLAYERBOTS_DB="NO"
+
+# Enjoy using the tool

docker/entrypoint-builder.sh

@@ -0,0 +1,430 @@
+#!/usr/bin/env bash
+#
+
+readonly SCRIPT_VERSION="1.0.0"
+
+set -e
+
+# Utils:
+#
+function echoerr()
+{
+    echo ${@} >&2
+}
+
+function success()
+{
+    echo -e "\e[32m${1}\e[0m"
+}
+function info()
+{
+    echo -e "\e[36m${1}\e[0m"
+}
+function warning()
+{
+    if [[ "${2}" == "--underline" ]]
+    then
+        echo -e "\e[4;33m${1}\e[0m"
+    else
+        echo -e "\e[33m${1}\e[0m"
+    fi
+}
+function error()
+{
+    if [[ "${2}" == "--underline" ]]
+    then
+        echo -e "\e[4;31m${1}\e[0m"
+    else
+        echo -e "\e[31m${1}\e[0m"
+    fi
+}
+
+function mysql_execute()
+{
+    mariadb "-h${MANGOS_DBHOST}" "-P${MANGOS_DBPORT}" "-u${MYSQL_SUPERUSER}" "-p${MYSQL_SUPERPASS}" ${@}
+}
+function mysql_dump()
+{
+    local DATABASE_NAME="${1}"
+    local OUTPUT_FILE="${2}"
+
+    mariadb-dump "-h${MANGOS_DBHOST}" "-P${MANGOS_DBPORT}" "-u${MYSQL_SUPERUSER}" "-p${MYSQL_SUPERPASS}" \
+        "${DATABASE_NAME}" --opt --result-file="${OUTPUT_FILE}"
+}
+
+# Sub-functions:
+#
+function install_updates()
+{
+    cd "${DATABASE_DIR}"
+
+    ./InstallFullDB.sh -UpdateCore
+
+    if [[ "${1}" == "--world" ]]
+    then
+        ./InstallFullDB.sh -World
+    fi
+}
+
+# Main functions:
+#
+function extract_resources_from_client()
+{
+    cd "${VOLUME_DIR}"
+
+    if [[ -f ".resext" ]] || [[ $(ls | grep -c -E "Cameras|dbc|maps|mmaps|vmaps") -gt 0 ]]
+    then
+        echo ""
+        echo -e " $(warning "WARNING!" --underline)"
+        echo -e "  $(warning "└") It seems that you've already extracted the resources from the client before."
+        echo -e "    If you continue, existing resources will be overwritten by the new ones."
+        echo ""
+        read -p "Are you sure to continue? [Y/n]: " ANSWER
+
+        if [[ "${ANSWER}" != "y" ]] && [[ "${ANSWER}" != "Y" ]]
+        then
+            echo -e " └ Ok, no problem! Resources have been left untouched."
+
+            return
+        fi
+
+        rm -rf Cameras/ \
+               dbc/ \
+               maps/ \
+               mmaps/ \
+               vmaps/
+    fi
+
+    cd "${HOME_DIR}/run/bin/tools"
+
+    cp * "${HOME_DIR}/wow-client/"
+    cd "${HOME_DIR}/wow-client"
+
+    ./ExtractResources.sh ${@}
+
+    mv Cameras "${VOLUME_DIR}/Cameras"
+    mv dbc "${VOLUME_DIR}/dbc"
+    mv maps "${VOLUME_DIR}/maps"
+    mv mmaps "${VOLUME_DIR}/mmaps"
+    mv vmaps "${VOLUME_DIR}/vmaps"
+
+    mkdir -p "${VOLUME_DIR}/logs"
+    mv *.log "${VOLUME_DIR}/logs/"
+
+    rm -rf Buildings/ \
+       \
+       ExtractResources.sh \
+       MoveMapGen \
+       MoveMapGen.sh \
+       ad \
+       offmesh.txt \
+       vmap_assembler \
+       vmap_extractor
+
+    echo "${SCRIPT_VERSION}" > "${VOLUME_DIR}/.resext"
+}
+function init_db()
+{
+    cd "${DATABASE_DIR}"
+
+    echo ""
+    echo "This procedure will create all the databases required by the server"
+    echo " to run properly and will initialize them with the default data."
+    echo ""
+    echo -e " $(warning "WARNING!" --underline)"
+    echo -e "  $(warning "└") Please note that, if you have already initialized the databases before,"
+                 echo -e "     this procedure will prune $(info "ALL") of your data and"
+                 echo -e "     they will be lost $(info "FOREVER") (it's a very long time)!"
+    echo ""
+    read -p "Are you sure to continue? [Y/n]: " ANSWER
+
+    if [[ "${ANSWER}" != "y" ]] && [[ "${ANSWER}" != "Y" ]]
+    then
+        echo -e " └ Ok, no problem! Databases have been left untouched."
+
+        return
+    fi
+
+    echo -e " └ Please, wait... Initializing databases..."
+    echo ""
+    echo -e " --------------------------------------"
+
+    ./InstallFullDB.sh -InstallAll "${MYSQL_SUPERUSER}" "${MYSQL_SUPERPASS}" DeleteAll
+}
+function backup_db()
+{
+    readonly HELP_MSG="
+Backups the specified database(s) and then returns the
+ result as a single \"tar.gz\" file via standard output.
+
+Usage:
+    backup-db [OPTIONS...]
+
+Options:
+    -a | --all
+        Backups all databases.
+
+    -w | --world
+        Backups the world database: \"$(info "${MANGOS_WORLD_DBNAME}")\".
+
+    -c | --characters
+        Backups the characters database: \"$(info "${MANGOS_CHARACTERS_DBNAME}")\".
+
+    -l | --logs
+        Backups the logs database: \"$(info "${MANGOS_LOGS_DBNAME}")\".
+
+    -r | --realmd
+        Backups the realmd database: \"$(info "${MANGOS_REALMD_DBNAME}")\".
+
+    -h | -? | --help
+        Displays this help message.
+"
+
+    declare -A DATABASES
+
+    while [[ ${#} -gt 0 ]]
+    do
+        case "${1}" in
+            -a | --all)
+                readonly BACKUPS_ALL="true"
+                ;;
+            -w | --world)
+                DATABASES+=(["world"]="${MANGOS_WORLD_DBNAME}")
+                ;;
+            -c | --characters)
+                DATABASES+=(["characters"]="${MANGOS_CHARACTERS_DBNAME}")
+                ;;
+            -l | --logs)
+                DATABASES+=(["logs"]="${MANGOS_LOGS_DBNAME}")
+                ;;
+            -r | --realmd)
+                DATABASES+=(["realmd"]="${MANGOS_REALMD_DBNAME}")
+                ;;
+            -h | -? | --help)
+                echo -e "${HELP_MSG}"
+
+                exit 0
+                ;;
+            *)
+                echoerr ""
+                echoerr -e " $(error "ERROR!" --underline)"
+                echoerr -e "  $(error "└") Unknown option: \"$(info "${1}")\""
+                echoerr ""
+                echoerr " Run \"$(info "backup-db --help")\" for more information."
+
+                exit 1
+                ;;
+        esac
+
+        shift
+    done
+
+    if [[ "${BACKUPS_ALL}" == "true" ]]
+    then
+        if [[ -n ${DATABASES[@]} ]]
+        then
+            echoerr ""
+            echoerr -e " $(error "ERROR!" --underline)"
+            echoerr -e "  $(error "└") You cannot specify both \"$(info "--all")\" and any other"
+            echoerr -e "     specific database options at the same time."
+            echoerr ""
+            echoerr " Run \"$(info "backup-db --help")\" for more information."
+
+            exit 2
+        fi
+
+        DATABASES=(["world"]="${MANGOS_WORLD_DBNAME}" \
+                   ["characters"]="${MANGOS_CHARACTERS_DBNAME}" \
+                   ["logs"]="${MANGOS_LOGS_DBNAME}" \
+                   ["realmd"]="${MANGOS_REALMD_DBNAME}")
+    fi
+    if [[ -z ${DATABASES[@]} ]]
+    then
+        echoerr ""
+        echoerr -e " $(error "ERROR!" --underline)"
+        echoerr -e "  $(error "└") You must specify at least one database to backup."
+        echoerr ""
+        echoerr " Run \"$(info "backup-db --help")\" for more information."
+
+        exit 3
+    fi
+
+    local TIMESTAMP="$(date +"%Y-%m-%d_%H-%M-%S")"
+    local BACKUP_DIR="/home/mangos/data/backups/${TIMESTAMP}"
+    local BACKUP_FILE="${BACKUP_DIR}/backup_${TIMESTAMP}.tar.gz"
+
+    mkdir -p "${BACKUP_DIR}"
+
+    for DATABASE in ${!DATABASES[@]}
+    do
+        local DATABASE_NAME="${DATABASES["${DATABASE}"]}"
+        local OUTPUT_FILENAME="${DATABASE}.sql"
+
+        mysql_dump "${DATABASE_NAME}" "${BACKUP_DIR}/${OUTPUT_FILENAME}"
+    done
+
+    cd "${BACKUP_DIR}"
+
+    echo "${SCRIPT_VERSION}" > .version
+    tar -czvf "${BACKUP_FILE}" .version $(ls *.sql | xargs -n 1) > /dev/null
+
+    cat "${BACKUP_FILE}"
+}
+function manage_db()
+{
+    cd "${DATABASE_DIR}"
+
+    ./InstallFullDB.sh
+}
+function restore_db()
+{
+    local TIMESTAMP="$(date +"%Y-%m-%d_%H-%M-%S")"
+    local TEMP_DIR="${TMPDIR}/${TIMESTAMP}"
+    local BACKUP_FILE="${TEMP_DIR}/backup_${TIMESTAMP}.tar.gz"
+
+    mkdir -p "${TEMP_DIR}"
+    cat - > "${BACKUP_FILE}"
+
+    cd "${TEMP_DIR}"
+
+    tar -xzvf "${BACKUP_FILE}" -C . > /dev/null
+
+    local BACKUP_FILES=($(ls *.sql | xargs -n 1))
+
+    for BACKUP_FILE in ${BACKUP_FILES[@]}
+    do
+        local DATABASE="${BACKUP_FILE%.sql}"
+
+        if [[ "${DATABASE}" == "world" ]]
+        then
+            local DATABASE_NAME="${MANGOS_WORLD_DBNAME}"
+        elif [[ "${DATABASE}" == "characters" ]]
+        then
+            local DATABASE_NAME="${MANGOS_CHARACTERS_DBNAME}"
+        elif [[ "${DATABASE}" == "logs" ]]
+        then
+            local DATABASE_NAME="${MANGOS_LOGS_DBNAME}"
+        elif [[ "${DATABASE}" == "realmd" ]]
+        then
+            local DATABASE_NAME="${MANGOS_REALMD_DBNAME}"
+        fi
+
+        mysql_execute "${DATABASE_NAME}" < "${TEMP_DIR}/${BACKUP_FILE}"
+    done
+}
+function update_db()
+{
+    readonly HELP_MSG="
+Updates databases by applying the latest changes
+ to the database structure and default data.
+Dy default, this is a non-destructive procedure,
+ so any custom data you may have loaded into
+ your \"$(info "${MANGOS_WORLD_DBNAME}")\" database will remain intact.
+
+Unfortunately, however, sometimes this plain update procedure
+ isn't enough to apply all the changes required by
+ the new version of the server to run properly.
+In these cases, you can use the \"$(info "--world")\" option to
+ perform a \"deeper\" update procedure to solve the issue.
+
+Please note that this more \"aggressive\" update procedure
+ will prune any custom data from the \"$(info "${MANGOS_WORLD_DBNAME}")\" database
+ and will restore the default data shipped with the server.
+If, however, you use an original version of the database
+ and have never customized any data, you can safely use
+ this option without any fear. No data will be lost.
+
+Usage:
+    update-db [OPTIONS...]
+
+Options:
+    -w | --world
+        Updates the world database: \"$(info "${MANGOS_WORLD_DBNAME}")\".
+
+    -h | -? | --help
+        Displays this help message.
+"
+    if [[ -n "${1}" ]]
+    then
+        case "${1}" in
+            -w | --world)
+                echo ""
+                echo -e " $(warning "WARNING!" --underline)"
+                echo -e "  $(warning "└") This procedure will prune all custom data you"
+                echo -e "     may have loaded into your \"$(info "${MANGOS_WORLD_DBNAME}")\" database."
+                echo ""
+                read -p "Are you sure to continue? [Y/n]: " ANSWER
+
+                if [[ "${ANSWER}" != "y" ]] && [[ "${ANSWER}" != "Y" ]]
+                then
+                    echo -e " └ Ok, no problem! Database have been left untouched."
+
+                    return
+                fi
+
+                echo -e " └ Please, wait... Updating database..."
+                echo ""
+                echo -e " --------------------------------------"
+
+                install_updates --world
+
+                ;;
+            -h | -? | --help)
+                echo -e "${HELP_MSG}"
+
+                exit 0
+                ;;
+            *)
+                echoerr ""
+                echoerr -e " $(error "ERROR!" --underline)"
+                echoerr -e "  $(error "└") Unknown option: \"$(info "${1}")\""
+                echoerr ""
+                echoerr " Run \"$(info "update-db --help")\" for more information."
+
+                exit 1
+                ;;
+        esac
+    else
+        install_updates
+    fi
+}
+
+# Execution:
+#
+case "${1}" in
+    extract)
+        shift
+
+        extract_resources_from_client ${@}
+        ;;
+    init-db)
+        shift
+
+        init_db
+        ;;
+    backup-db)
+        shift
+
+        backup_db ${@}
+        ;;
+    restore-db)
+        shift
+
+        restore_db ${@}
+        ;;
+    manage-db)
+        shift
+
+        manage_db
+        ;;
+    update-db)
+        shift
+
+        update_db ${@}
+        ;;
+    *)
+        cd "${HOME_DIR}"
+
+        exec ${@}
+        ;;
+esac

docker/entrypoint-runner.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+#
+
+set -e
+
+# Utils:
+#
+function _replace_conf()
+{
+    local SEARCH_FOR="${1}"
+    local REPLACE_WITH="${2}"
+    local FILENAME="${3}"
+
+    sed -i "/^${SEARCH_FOR}/c\\${SEARCH_FOR} = ${REPLACE_WITH}" "${FILENAME}"
+}
+function _merge_confs()
+{
+    local FILENAME="${1}"
+    local CONFIG_FILE="${2}"
+
+    while IFS='' read -r LINE || [[ -n "${LINE}" ]]
+    do
+        PROPERTY="$(echo "${LINE}" | cut -d '#' -f 1 | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+
+        if [[ -n "${PROPERTY}" ]]
+        then
+            local SEARCH_FOR="$(echo "${PROPERTY}" | cut -d '=' -f 1 | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+            local REPLACE_WITH="$(echo "${PROPERTY}" | cut -d '=' -f 2- | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+
+            _replace_conf "${SEARCH_FOR}" "${REPLACE_WITH}" "${FILENAME}"
+        fi
+
+    done < "${CONFIG_FILE}"
+}
+
+# Sub-functions:
+#
+function compose_mangosd_conf()
+{
+    local MANGOS_DBCONN="${MANGOS_DBHOST};${MANGOS_DBPORT};${MANGOS_DBUSER};${MANGOS_DBPASS}"
+
+    cd "${MANGOS_DIR}/etc"
+    cp mangosd.conf.dist mangosd.conf
+
+    _replace_conf "LoginDatabaseInfo" "\"${MANGOS_DBCONN};${MANGOS_REALMD_DBNAME}\"" mangosd.conf
+    _replace_conf "WorldDatabaseInfo" "\"${MANGOS_DBCONN};${MANGOS_WORLD_DBNAME}\"" mangosd.conf
+    _replace_conf "CharacterDatabaseInfo" "\"${MANGOS_DBCONN};${MANGOS_CHARACTERS_DBNAME}\"" mangosd.conf
+    _replace_conf "LogsDatabaseInfo" "\"${MANGOS_DBCONN};${MANGOS_LOGS_DBNAME}\"" mangosd.conf
+
+    if [[ -f "/opt/mangos/conf/mangosd.conf" ]]
+    then
+        _merge_confs mangosd.conf "/opt/mangos/conf/mangosd.conf"
+    fi
+}
+function compose_realmd_conf()
+{
+    local MANGOS_DBCONN="${MANGOS_DBHOST};${MANGOS_DBPORT};${MANGOS_DBUSER};${MANGOS_DBPASS}"
+
+    cd "${MANGOS_DIR}/etc"
+    cp realmd.conf.dist realmd.conf
+
+    _replace_conf "LoginDatabaseInfo" "\"${MANGOS_DBCONN};${MANGOS_REALMD_DBNAME}\"" realmd.conf
+
+    if [[ -f "/opt/mangos/conf/realmd.conf" ]]
+    then
+        _merge_confs realmd.conf "/opt/mangos/conf/realmd.conf"
+    fi
+}
+
+function set_timezone()
+{
+    ln -snf "/usr/share/zoneinfo/${TZ}" /etc/localtime
+    echo "${TZ}" > /etc/timezone
+
+    dpkg-reconfigure --frontend noninteractive tzdata &> /dev/null
+}
+
+function wait_for_database()
+{
+    wait-for-it -h "${MANGOS_DBHOST}" -p "${MANGOS_DBPORT}"
+}
+
+# Main functions:
+#
+function init_runner()
+{
+    set_timezone
+
+    compose_mangosd_conf
+    compose_realmd_conf
+}
+
+function run_mangosd()
+{
+    cd "${MANGOS_DIR}/bin"
+
+    gosu mangos ./mangosd
+}
+function run_realmd()
+{
+    cd "${MANGOS_DIR}/bin"
+
+    gosu mangos ./realmd
+}
+
+# Execution:
+#
+init_runner
+
+case "${1}" in
+    mangosd)
+        shift
+
+        wait_for_database
+        run_mangosd ${@}
+        ;;
+    realmd)
+        shift
+
+        wait_for_database
+        run_realmd ${@}
+        ;;
+    *)
+        cd "${HOME_DIR}"
+
+        exec ${@}
+        ;;
+esac
+
+exit 1

docker/run.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+#
+
+set -e
+
+readonly BASE_DIR="$(realpath "$(dirname "${0}")/..")"
+source "${BASE_DIR}/.env"
+
+readonly NAME="cmangos-builder"
+readonly IMAGE="wow-server-${WOW_VERSION}:builder"
+readonly VERSION="latest"
+
+readonly DATA_VOLUME="./mangosd_data"
+readonly NETWORK="wow"
+
+if [[ -t 0 ]] && [[ -t 1 ]]
+then
+    readonly TTY="-it"
+else
+    readonly TTY="-i"
+fi
+
+docker run ${TTY} \
+           --name "${NAME}" \
+           --network "${NETWORK}" \
+           --rm \
+           -e MYSQL_SUPERUSER="root" \
+           -e MYSQL_SUPERPASS="${MYSQL_SUPERPASS}" \
+           -e MANGOS_DBHOST="database" \
+           -e MANGOS_DBUSER="${MANGOS_DBUSER}" \
+           -e MANGOS_DBPASS="${MANGOS_DBPASS}" \
+           -v "${DATA_VOLUME}":/home/mangos/data \
+           -v "${WOW_CLIENT_DIR}":/home/mangos/wow-client \
+    \
+    "${IMAGE}:${VERSION}" ${@}

install.sh

@@ -1,198 +0,0 @@
-#!/bin/bash
-
-CURRENT_USER=${SUDO_USER:-$CURRENT_USER}
-REALM_IP=$(hostname -I | awk '{print $1}')
-
-# CONFIG
-MANGOS_ETC="/home/"$CURRENT_USER"/vmangos/etc"
-MANGOS_DATA="/home/"$CURRENT_USER"/vmangos/data"
-MANGOS_LOGS="/home/"$CURRENT_USER"/vmangos/logs"
-
-MYSQL_ROOT_PASS="greg"
-MANGOS_DB_PASS="mangos"
-
-REALM_NAME="wow-garage"
-
-# DEPENDENCIES
-echo "[INFO] Configuration & dependencies installation ..."
-
-sudo systemctl stop apt-daily.timer
-sudo systemctl disable apt-daily.timer
-
-sudo apt update && sudo apt install p7zip-full git wget g++ cmake openssl libssl-dev build-essential checkinstall zlib1g-dev mariadb-server mariadb-client libmariadb-dev libmariadb-dev-compat libreadline-dev -y
-
-sudo apt install -qq libace-dev -y
-export ACE_ROOT=/usr/include/ace
-
-sudo apt install -y libtbb-dev -y
-export TBB_ROOT_DIR=/usr/include/tbb
-
-# CLONING PROJECT
-echo "[INFO] Cloning project ..."
-
-sudo mkdir -p /home/$CURRENT_USER/vmangos
-sudo chown -R $CURRENT_USER:$CURRENT_USER /home/$CURRENT_USER
-cd /home/$CURRENT_USER/vmangos
-git clone -b development https://github.com/vmangos/core && git clone https://github.com/brotalnia/database vmangos/db
-
-mkdir -p /home/$CURRENT_USER/build
-cd /home/$CURRENT_USER/build
-sudo cmake /home/$CURRENT_USER/vmangos/core -DDEBUG=0 -DSUPPORTED_CLIENT_BUILD=5875 -DUSE_EXTRACTORS=0 -DCMAKE_INSTALL_PREFIX=$HOME/vmangos
-
-# BUILDING PROJECT
-echo "[INFO] building $CURRENT_USER ..."
-
-sudo make -j $(nproc) install
-
-# GETTING DATAS
-echo "[INFO] Getting datas ..."
-
-cd /home/$CURRENT_USER/vmangos
-wget https://www.mediafire.com/file_premium/j6cyqjeif3dvrv2/data.7z
-7z x data.7z
-rm -r data.7z
-
-# MISE EN PLACE DES FICHIERS
-echo "[INFO] Mise en place des fichiers ..."
-
-mkdir /home/$CURRENT_USER/vmangos/etc
-
-sudo chown -R $CURRENT_USER:$CURRENT_USER /home/$CURRENT_USER/vmangos
-
-sudo cp /root/vmangos/etc/realmd.conf.dist /home/$CURRENT_USER/vmangos/etc/mangosd.conf
-sudo cp /root/vmangos/etc/mangosd.conf.dist /home/$CURRENT_USER/vmangos/etc/realmd.conf
-
-sudo chown -R $CURRENT_USER:$CURRENT_USER /home/$CURRENT_USER/vmangos
-
-mkdir -p /home/$CURRENT_USER/vmangos/logs/{mangosd,realmd,honor}
-
-# CONFIG AGAIN
-echo "[INFO] Configuration de mangosd.conf ..."
-
-sed -i \
-    -e "s|^DataDir.*|DataDir = \"$MANGOS_DATA\"|" \
-    -e "s|^LogsDir.*|LogsDir = \"$MANGOS_LOGS/mangosd\"|" \
-    -e "s|^HonorDir.*|HonorDir = \"$MANGOS_LOGS/honor\"|" \
-    "$MANGOS_ETC/mangosd.conf"
-
-echo "[INFO] Configuration de realmd.conf ..."
-sed -i \
-    -e "s|^LogsDir.*|LogsDir = \"$MANGOS_LOGS/realmd\"|" \
-    "$MANGOS_ETC/realmd.conf"
-
-# MYSQL SECURE INSTALLATION
-echo "[INFO] Sécurisation de MySQL ..."
-
-sudo mysql <<EOF
-DELETE FROM mysql.user WHERE User='';
-DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost');
-DROP DATABASE IF EXISTS test;
-DELETE FROM mysql.db WHERE Db='test' OR Db='test\\_%';
-FLUSH PRIVILEGES;
-EOF
-
-sudo mysql --user=root --password="${MYSQL_ROOT_PASS}" <<EOF
-DROP USER IF EXISTS 'mangos'@'localhost';
-
-CREATE USER 'mangos'@'localhost' IDENTIFIED BY '${MANGOS_DB_PASS}'
-WITH MAX_QUERIES_PER_HOUR 0
-     MAX_CONNECTIONS_PER_HOUR 0
-     MAX_UPDATES_PER_HOUR 0;
-
-GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-
-CREATE DATABASE IF NOT EXISTS \`realmd\`
-    DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-CREATE DATABASE IF NOT EXISTS \`mangos\`
-    DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-CREATE DATABASE IF NOT EXISTS \`characters\`
-    DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-CREATE DATABASE IF NOT EXISTS \`logs\`
-    DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-
-GRANT ALL PRIVILEGES ON \`realmd\`.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-GRANT ALL PRIVILEGES ON \`mangos\`.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-GRANT ALL PRIVILEGES ON \`characters\`.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-GRANT ALL PRIVILEGES ON \`logs\`.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-
-FLUSH PRIVILEGES;
-EOF
-
-# not sure of usefullness
-sudo mysql -u root -p"${MYSQL_ROOT_PASS}" -e "SHOW GRANTS FOR 'mangos'@'localhost';"
-# end of 'not sure of usefullness'
-
-sudo mysql -u root -p"${MYSQL_ROOT_PASS}" <<EOF
-DROP USER IF EXISTS 'mangos'@'localhost';
-CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'mangos';
-GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost' WITH GRANT OPTION;
-FLUSH PRIVILEGES;
-EOF
-
-# FINAL CONFIGS
-cd /home/$CURRENT_USER/vmangos/vmangos/db/
-
-wget https://github.com/brotalnia/database/blob/master/world_full_14_june_2021.7z?raw=true
-
-7z x world_full_14_june_2021.7z
-sudo mysql -u mangos -pmangos --database=mangos < world_full_14_june_2021.sql
-rm -r world_full_14_june_2021.sql
-
-cd /home/$CURRENT_USER/vmangos/core/sql/
-
-mysql -u mangos -pmangos --database=characters < characters.sql
-mysql -u mangos -pmangos --database=logs < logs.sql
-mysql -u mangos -pmangos --database=realmd < logon.sql
-
-sudo mysql -u root -p"${MYSQL_ROOT_PASS}" <<EOF
-
-USE mangos;
-
-ALTER TABLE locales_item
-MODIFY COLUMN name_loc1 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc2 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc3 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc4 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc5 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc6 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc7 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc8 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci';
-
-ALTER TABLE locales_creature
-MODIFY COLUMN name_loc1 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc2 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc3 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc4 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc5 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc6 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc7 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc8 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci';
-
-ALTER TABLE locales_gameobject
-MODIFY COLUMN name_loc1 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc2 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc3 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc4 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc5 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc6 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc7 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci',
-MODIFY COLUMN name_loc8 VARCHAR(100) NULL DEFAULT '' COLLATE 'utf8_general_ci';
-
-USE realmd;
-
-DELETE FROM realmlist WHERE id=1;
-INSERT INTO realmlist (id, name, address, localAddress, localSubnetMask, icon, timezone, realmbuilds)
-VALUES (1, $REALM_NAME, $REALM_IP, '127.0.0.1', '255.255.255.0', 1, 2, '5875 6005 6141');
-
-EOF
-
-# MIGRATIONS
-cd /home/$CURRENT_USER/vmangos/core/sql/migrations
-
-./merge.sh
-
-mysql -u mangos -pmangos --database=mangos < world_db_updates.sql
-mysql -u mangos -pmangos --database=logs < logs_db_updates.sql
-mysql -u mangos -pmangos --database=characters < characters_db_updates.sql
-mysql -u mangos -pmangos --database=realmd < logon_db_updates.sql
-

mangosd.conf

@@ -0,0 +1,56 @@
+
+###################################################################################################################
+#
+#    GameType
+#        Server realm style
+#        0 = NORMAL; 1 = PVP; 4 = NORMAL; 6 = RP; 8 = RPPVP
+#        also custom type: 16 FFA_PVP (free for all pvp mode like arena PvP in all zones except rest
+#        activated places and sanctuaries)
+#
+#    RealmZone
+#        Server realm zone (set allowed alphabet in character names/etc). See also Strict*Names options.
+#
+#        1 Development    - any language (Default)
+#        2 United States  - extended-Latin
+#        3 Oceanic        - extended-Latin
+#        4 Latin America  - extended-Latin
+#        5 Tournament     - basic-Latin at create, any at login
+#        6 Korea          - East-Asian
+#        7 Tournament     - basic-Latin at create, any at login
+#        8 English        - extended-Latin
+#        9 German         - extended-Latin
+#        10 French        - extended-Latin
+#        11 Spanish       - extended-Latin
+#        12 Russian       - Cyrillic
+#        13 Tournament    - basic-Latin at create, any at login
+#        14 Taiwan        - East-Asian
+#        15 Tournament    - basic-Latin at create, any at login
+#        16 China         - East-Asian
+#        17 CN1           - basic-Latin at create, any at login
+#        18 CN2           - basic-Latin at create, any at login
+#        19 CN3           - basic-Latin at create, any at login
+#        20 CN4           - basic-Latin at create, any at login
+#        21 CN5           - basic-Latin at create, any at login
+#        22 CN6           - basic-Latin at create, any at login
+#        23 CN7           - basic-Latin at create, any at login
+#        24 CN8           - basic-Latin at create, any at login
+#        25 Tournament    - basic-Latin at create, any at login
+#        26 Test Server   - any language
+#        27 Tournament    - basic-Latin at create, any at login
+#        28 QA Server     - any language
+#        29 CN9           - basic-Latin at create, any at login
+#
+#    RabbitDay
+#        Set to Rabbit Day (date in unix time), only the day and month are considered, the year is not important
+#        Default: 0 (off)
+#        Suggested: 954547200 (April 1st, 2000)
+#
+#    Motd
+#        Message of the Day. Displayed at worldlogin for every user ('@' for a newline).
+#
+####################################################################################################################
+
+GameType = 0
+RealmZone = 8
+RabbitDay = 954547200
+Motd = "Bienvenue en Azeroth!"

php/Dockerfile

@@ -0,0 +1,22 @@
+FROM php:8.2-apache
+
+# Installer les dépendances nécessaires pour compiler les extensions PHP
+RUN apt-get update && apt-get install -y \
+    unzip \
+    git \
+    libgmp-dev \
+    libzip-dev \
+    libxml2-dev \
+    default-mysql-client \
+    && docker-php-ext-install mysqli gmp soap \
+    && rm -rf /var/lib/apt/lists/*
+
+# Installer composer
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+# Copier l'application
+WORKDIR /var/www/html
+COPY ./index.php ./srp6.php ./composer.json ./
+
+# Installer les dépendances PHP
+RUN composer install --no-dev --optimize-autoloader

php/composer.json

@@ -0,0 +1,15 @@
+{
+    "name": "wow/account-web",
+    "description": "Web panel to create WoW accounts with SRP6 and OIDC authentication",
+    "require": {
+        "php": ">=8.0",
+        "jumbojett/openid-connect-php": "^0.9.6",
+        "ext-gmp": "*",
+        "ext-mysqli": "*"
+    },
+    "autoload": {
+        "files": [
+            "srp6.php"
+        ]
+    }
+}

php/index.php

@@ -0,0 +1,58 @@
+<?php
+require __DIR__ . '/vendor/autoload.php';
+
+use Jumbojett\OpenIDConnectClient;
+
+// session_start();
+
+// // --- OIDC login ---
+// $oidc = new OpenIDConnectClient(
+//     getenv('OIDC_ISSUER'),
+//     getenv('OIDC_CLIENT_ID'),
+//     getenv('OIDC_CLIENT_SECRET')
+// );
+
+// if (!isset($_SESSION['user'])) {
+//     $oidc->authenticate();
+//     $_SESSION['user'] = $oidc->getVerifiedClaims();
+// }
+
+// --- Formulaire pour créer un compte ---
+if ($_SERVER['REQUEST_METHOD'] === 'POST') {
+    $user = $_POST['username'];
+    $pass = $_POST['password'];
+
+    $soapUser = 'SOAPUSER';
+    $soapPass = 'SOAPPASS';
+    $host = getenv('SOAP_HOST');
+    $port = getenv('SOAP_PORT');
+
+    $command = "account create $user $pass";
+    $command = "account list";
+
+    $client = new SoapClient(NULL, [
+        "location" => "http://mangosd:7878/",
+        "uri" => "urn:MaNGOS",
+        "style" => SOAP_RPC,
+        'login' => $soapUser,
+        'password' => $soapPass
+    ]);
+
+    try {
+        // NOTE : ne pas mettre de préfixe ns1:
+        $result = $client->__soapCall('executeCommand', [new SoapParam($command, 'command')]);
+        echo "✅ Command executed:\n";
+        echo $result;
+        var_dump($result);
+    } catch (Exception $e) {
+        echo "❌ Command failed:\n";
+        echo $e->getMessage();
+    }
+}
+?>
+
+<form method="post">
+    <input type="text" name="username" placeholder="Username" required>
+    <input type="password" name="password" placeholder="Password" required>
+    <button type="submit">Create Account</button>
+</form>

php/srp6.php

@@ -0,0 +1,50 @@
+<?php
+/**
+ * SRP6 (WoW/MaNGOS) – génération de v et s corrects.
+ * Points clés :
+ * - USERNAME & PASSWORD en MAJUSCULES
+ * - x = SHA1( salt || SHA1(USER:PASS) )
+ * - N = 0x894B...E9BB7 (256-bit), g = 7
+ * - Endianness : on évite gmp_import et on passe par hex pour ne pas se tromper
+ * - Hex MAJUSCULE + padding à la longueur de N
+ */
+final class SRP6
+{
+    // N et g utilisés par WoW (256-bit)
+    private const N_HEX = '894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7';
+    private const G_HEX = '07';
+
+    public static function createVerifierAndSalt(string $username, string $password): array
+    {
+        $U = strtoupper($username);
+        $P = strtoupper($password);
+
+        // 32 octets de sel (=> 64 hex)
+        $saltBin = random_bytes(32);
+
+        // h1 = SHA1(U:P)
+        $h1 = sha1($U . ':' . $P, true);
+
+        // h2 = SHA1(salt || h1)
+        $h2 = sha1($saltBin . $h1, true);
+
+        // x = int( h2 ) (interprété comme un entier non signé big-endian)
+        // -> on passe par l'hex pour éviter les soucis d'endianness
+        $x = gmp_init(bin2hex($h2), 16);
+
+        $N = gmp_init(self::N_HEX, 16);
+        $g = gmp_init(self::G_HEX, 16);
+
+        // v = g^x mod N
+        $v = gmp_powm($g, $x, $N);
+
+        // Longueur hex attendue = longueur de N en hex (ici 64 chars)
+        $nLen = strlen(self::N_HEX);
+
+        // Hex MAJUSCULE + padding
+        $vHex = strtoupper(str_pad(gmp_strval($v, 16), $nLen, '0', STR_PAD_LEFT));
+        $sHex = strtoupper(str_pad(bin2hex($saltBin), 64, '0', STR_PAD_LEFT)); // 32 bytes => 64 hex
+
+        return ['v' => $vHex, 's' => $sHex];
+    }
+}

scripts/create_realm.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+#
+
+set -e
+
+readonly BASE_DIR="$(realpath "$(dirname "${0}")/..")"
+source "${BASE_DIR}/.env"
+
+# Nom du conteneur Docker
+CONTAINER="wow-mangosd"
+
+function create_realm() {
+    local REALM_NAME="${1}"
+    local REALM_ADDRESS="${2}"
+
+    # Variables fixes
+    REALM_ID=1
+    REALM_PORT=8085
+
+    echo "⚙️  Configuration du realm '$REALM_NAME' ($REALM_ADDRESS:$REALM_PORT)..."
+
+    # Exécution des requêtes SQL via un client mysql externe
+    docker run --rm -i \
+        --network container:$CONTAINER \
+        mysql:5.7 \
+        mysql -hdatabase -u$MANGOS_DBUSER -p$MANGOS_DBPASS ${WOW_VERSION}realmd <<EOF
+DELETE FROM realmlist WHERE id = $REALM_ID;
+
+INSERT INTO realmlist (id, name, address, port, icon, realmflags, timezone, allowedSecurityLevel)
+VALUES ('$REALM_ID', '$REALM_NAME', '$REALM_ADDRESS', '$REALM_PORT', '1', '0', '8', '0');
+EOF
+
+    echo "✅ Realm '$REALM_NAME' avec IP '$REALM_ADDRESS' a été configuré."
+}
+
+# function create_account() {
+#     local ACCOUNT_NAME="${1}"
+#     local ACCOUNT_PASS="${2}"
+#     local GMLEVEL="${3:-0}"
+
+#     echo "⚙️  Création du compte '$ACCOUNT_NAME' (GM level $GMLEVEL)..."
+
+#     # Création via le binaire mangosd dans le conteneur
+#     docker exec -i $CONTAINER /opt/mangos/bin/realmd account create "$ACCOUNT_NAME" "$ACCOUNT_PASS -c /opt/mangos/conf/realmd.conf"
+#     docker exec -i $CONTAINER /opt/mangos/bin/realmd account set gmlevel "$ACCOUNT_NAME" "$GMLEVEL" -1 "-c /opt/mangos/conf/realmd.conf"
+#     # Attribution du GM level si nécessaire
+#     if [ "$GMLEVEL" -gt 0 ]; then
+#         docker exec -i $CONTAINER /opt/mangos/bin/mangosd account set gmlevel "$ACCOUNT_NAME" "$GMLEVEL" -1
+#     fi
+
+#     echo "✅ Compte '$ACCOUNT_NAME' créé avec succès (GM level $GMLEVEL)."
+# }
+
+case "${1}" in
+    create_realm)
+        shift
+        create_realm "${@}"
+        ;;
+    create_account)
+        shift
+        create_account "${@}"
+        ;;
+    *)
+        cd "${HOME_DIR}"
+        exec "${@}"
+        ;;
+esac

soap.php

@@ -0,0 +1,59 @@
+<?php
+/*
+ * This file is part of the CMaNGOS Project. See AUTHORS file for Copyright information
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/**
+ * MaNGOSsoap client example
+ *
+ * a simple example how to invoke commands using SOAP
+ *
+ * Make sure you enabled SOAP in your mangosd.conf!
+ *  SOAP.Enabled = 1
+ */
+
+/*
+ * $username and $password MUST be uppercase
+ * account $username needs at least SEC_ADMINISTRATOR
+ */
+$username = 'ADMINISTRATOR';
+$password = 'ADMINISTRATOR';
+
+$host = "localhost";
+$soapport = 7878;
+$command = "server info";
+
+$client = new SoapClient(NULL,
+array(
+    "location" => "http://$host:$soapport/",
+    "uri" => "urn:MaNGOS",
+    "style" => SOAP_RPC,
+    'login' => $username,
+    'password' => $password
+));
+
+try {
+    $result = $client->executeCommand(new SoapParam($command, "command"));
+
+    echo "Command succeeded! Output:<br />\n";
+    echo $result;
+}
+catch (Exception $e)
+{
+    echo "Command failed! Reason:<br />\n";
+    echo $e->getMessage();
+}