Skip to main content

A Python API Wrapper for ArtifactsMMO

Project description

ArtifactsMMO API Wrapper

PyPI - Version PyPI - License GitHub Release Date PyPI - Downloads

Disclaimer

This wrapper is a third-party tool and is not officially affiliated with Artifacts MMO. Use it responsibly and at your own risk. Be aware of the game's terms of service and avoid any actions that could violate them.

Overview

Hello! Glad you stumbled onto this wrapper. This is by far my biggest undertaking yet, and it only gets bigger.

This is a Python wrapper for interacting with the Artifacts MMO API, providing an easy way to interact with the game's data, perform in-game actions, and manage character and account information. This library simplifies API requests and provides a range of features to integrate with Artifacts MMO's online functionalities.

Features

  • Character Management: Create, delete, and manage character data.

  • In-Game Actions: Move, gather, craft, fight, and other interactive commands.

  • Task Management: Accept, complete, and exchange tasks from the taskmaster.

  • Grand Exchange: Manage and fulfill sell orders and view order history

  • Inventory and Equipment Management: View, equip, and manage items.

  • Bank and Gold Management: Deposit and withdraw gold or items.

  • Leaderboard and Events: View event and leaderboard data.

How to install

Using pip (Recommended method)

pip install artifactsmmo-wrapper

Using conda (Recommended method)

conda install artifactsmmo-wrapper

Manually using pip (Only use this method if you know what you're doing)

mkdir artifactsmmo-wrapper
cd artifactsmmo-wrapper

git clone https://github.com/veillax/ArtifactsMMO-Wrapper.git
cd ArtifactsMMO-Wrapper

# Normal mode
pip install .

# Editable mode
# pip install -e .

Quick Disclaimer

Some of the following text is taken from the ArtifactsMMO Website to ensure it is accurate and well put for beginner developers or new players to be able to understand. It is adapted to match the information available within this wrapper though

How to begin playing ArtifactsMMO

Artifacts is an asynchronous MMORPG in which you can control up to 5 characters at the same time. Your characters can fight monsters, gather resources, craft items and much more.

This wrapper however is thus far a synchronous wrapper, so you have to use the threading module to control more than one character at once

Unlike a traditional game, you'll have to write your own scripts in your preferred programming language to control your characters via an API.

This wrapper is an easy way to get started with playing ArtifactsMMO Season 3. It allows you to access the API without writing too much complex code.

For another quick start, you can write your own Javascript scripts directly in the client's code editor, otherwise you can use any language you like on your own IDE. You can see examples in other programming languages in the Reference API.

Before You Begin

The first step is to create your account and your first character by logging in. After that you'll need your token, which you can find on your account. ⚠️ It is not allowed to play with more than one account. All accounts involved in multi-accounting will be banned

API Token Box

⚠️ The token is used by the server to identify you when you make requests. It is important to keep it secret.

You can now open the game client by clicking here.

The built in editor supports Node.JS only. It is recommended to use VS Code or Pycharm with this wrapper

Ready to start?

Visit ArtifactsMMO Wrapper on PyPi to view the python package

Links

Wrapper Tutorials, Examples, and Specs ArtifactsMMO Website
ArtifactsMMO Discord
ArtifactsMMO Docs
ArtifactsMMO Encyclopidea
ArtifactsMMO API Docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

artifactsmmo_wrapper-3200.0.2.tar.gz (37.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

artifactsmmo_wrapper-3200.0.2-py3-none-any.whl (37.8 kB view details)

Uploaded Python 3

File details

Details for the file artifactsmmo_wrapper-3200.0.2.tar.gz.

File metadata

  • Download URL: artifactsmmo_wrapper-3200.0.2.tar.gz
  • Upload date:
  • Size: 37.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for artifactsmmo_wrapper-3200.0.2.tar.gz
Algorithm Hash digest
SHA256 004eccc514161e74bbf1d8f70b8281ef826f1ae0d6d0000a2d546d8991bbc8cf
MD5 276cb06558f14cb0082149ddfb50b760
BLAKE2b-256 a63ec47b0087b2c426b007f52d0a5b25563418d055e6a9974b6c2a4483bd1513

See more details on using hashes here.

File details

Details for the file artifactsmmo_wrapper-3200.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for artifactsmmo_wrapper-3200.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8e84c637d0e191424ff382955816e3f109bf469faeb6fd224cae66dfebbf054d
MD5 9fa759720797f7da6070155e3857c0c4
BLAKE2b-256 ea95fd000d6aeb0f6e108b37cbb7564eb6d4226ad1afb9e8c0481e015bf867a1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page