AzerothCore-Armory is a website that enables you to view your AzerothCore server's characters and guilds.
At the time I started working on this project (end of 2021), there were virtually no modern and public/open-source armory projects.
I also noticed that such a tool was frequently requested in the AzerothCore Discord server, so I decided to make one. Hope you like it!

• Node.js
• TypeScript
• Express JS
• Handlebars
• JQuery
• DataTables
• Bulma

(back to top)

• Node.js
• An AzerothCore-based server database
• (Optional) Docker

1. Clone the repository:
   • With HTTPS:

      git clone https://github.com/r-o-b-o-t-o/azerothcore-armory.git

     OR
   • With SSH:

      git clone [email protected]:r-o-b-o-t-o/azerothcore-armory.git

2. Install the dependencies:

   cd azerothcore-armory/
   npm install

3. Configure the application: copy config.default.json to config.json or .env.example to .env and edit the resulting file.
   See the Configuration Reference below for a description of all values.
4. Download the model viewer's data:
   • Download from script:

      npm run build
      npm run fetchdata

     OR
   • Download the latest archive (data.zip) from the Releases page and extract it to the data/ directory.

(back to top)

Build the application:

npm run build

Start the application:

npm start

Open a web browser and navigate to http://localhost:48733

Other useful npm scripts:

• npm run clean: cleans the build directory
• npm run watch: watches for changes and rebuilds automatically, useful for development
• npm run fetchdata: downloads the data needed by the 3d model viewer
• npm run cleardata: clears the data downloaded for the 3d model viewer

You can also use Docker, simply use docker-compose:

cd azerothcore-armory/
docker-compose up -d

Note: the Docker version supports only the .env file for configuration, not config.json

You might want to integrate the application directly into your existing website using an iframe.

1. Set iframeMode.enabled to true in your configuration.
2. Set iframeMode.url in your configuration to the URL in your website that the armory will be accessible from (the page hosting the iframe).
3. Embed the code snippet below into your page.
   Make sure you replace the URL http://localhost:48733 with your Armory's URL (the same URL as iframeMode.url) at the end of the code snippet.

<style>
	#armory-iframe {
		/*
		* Using min-width to set the width of the iFrame, works around an issue in iOS that can prevent the iFrame from sizing correctly.
		* See: https://github.com/davidjbradshaw/iframe-resizer
		*/
		width: 1px;
		min-width: 100%;

		border: none;
	}
</style>

<iframe id="armory-iframe"></iframe>

<script type="application/javascript" src="https://cdn.jsdelivr.net/npm/[email protected]/js/iframeResizer.min.js"></script>
<script type="application/javascript">
	let resizeSetup = false;
	window.addEventListener("message", (ev) => {
		if (ev.data.url !== undefined) {
			const url = ev.data.url.trim().replace(/^\//, "");
			window.history.replaceState(null, null, url === "" ? window.location.pathname : ("?" + url));
		} else if (ev.data === "contentLoaded") {
			if (!resizeSetup) {
				iFrameResize({ checkOrigin: false, autoResize: true }, "#armory-iframe");
				resizeSetup = true;
			} else {
				document.getElementById("armory-iframe").iFrameResizer.resize();
			}
		}
	});

	const iframe = document.getElementById("armory-iframe");
	const url = window.location.search.replace(/^\?/, "");
	iframe.src = "http://localhost:48733/" + url;
</script>

This repository is used in production over at ChromieCraft, check it out there!

(back to top)

• Characters list / search page
• Character page
  • Online/offline status
  • Equipment with tooltips
  • 3d model, including mounts
  • Talent trees, including glyphs and dual spec support
  • Achievements
  • PvP statistics, including arena teams
  • Statistics (from the achievements panel in-game)
  • Reputations
  • Stats (from the character sheet, i.e. health, mana, etc)
• Guild page
  • Guild emblem
  • Members list
  • PvE statistics
• Multiple realms support
• PvE ladder
• PvP ladder

See the open issues for a list of suggested features and known issues.

(back to top)

Any and all contributions are greatly appreciated.

If you have a suggestion that would make this project better, feel free to fork the repository and create a Pull Request. You can also open a Feature Request.

(back to top)

⭐️ Give the project a star if you like it!

(back to top)

Distributed under the MIT License. See the LICENSE file for more information.

(back to top)

Feel free to get in touch with me on Discord: Roboto#9185

(back to top)