Metadata-Version: 2.0
Name: mccurse
Version: 0.1.2
Summary: Minecraft Curse CLI Client
Home-page: https://github.com/khardix/mccurse
Author: Jan "Khardix" Staněk
Author-email: khardix@gmail.com
License: AGPLv3+
Keywords: minecraft modding automation
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: attrs
Requires-Dist: click
Requires-Dist: ijson
Requires-Dist: pyxdg
Requires-Dist: requests
Requires-Dist: sqlalchemy
Requires-Dist: urwid
Provides-Extra: test
Requires-Dist: betamax; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: responses; extra == 'test'
Requires-Dist: pyfakefs (>2.9); extra == 'test'

Minecraft Curse CLI Client
==========================

This project is my humble attempt at creating an automated way of installing,
updating and managing mods for my Minecraft games. Using 
`Curse.RestProxy <https://github.com/amcoder/Curse.RestProxy>`_ as its primary
data source, it can find mods and their updates on Minecraft `CurseForge`_ and
automatically install them for you.

.. _CurseForge: https://minecraft.curseforge.com/

Current test status: |travis|

.. |travis| image:: https://travis-ci.org/khardix/mccurse.svg?branch=master
                 :target: https://travis-ci.org/khardix/mccurse

Usage
-----

The ``mccurse`` command provides various subcommands, described below.

Querying
^^^^^^^^

``mccurse search TEXT`` – Search available mods on `CurseForge`_, then presents
the user with list of possible matches. If the user choose one of them, it opens
its project page in the default browser.

Mod Management
^^^^^^^^^^^^^^

All the commands below presume that they are run in the profile directory of
a Minecraft instance.

``mccurse auth`` – Authenticate with your Curse account and store the auth token
for later use.

``mccurse new VERSION`` – Initialize new metadata file for current profile,
which will hold all the necessary info for installed mods. ``VERSION`` is the
Minecraft version of the instance (i.e. ``1.10.2``).

``mccurse install MOD`` – Install new mod, including its required dependencies,
to the current Minecraft instance.

``mccurse upgrade [all|MOD]`` – Upgrade mods to their latest version for current
game version. ``all`` upgrades all mods with available upgrades, ``MOD`` only
the specified one.

``mccurse remove MOD`` – Uninstall the ``MOD`` and its no longer needed
dependencies.

License
-------

``mccurse`` is released under the terms of `GNU Affero General Public License
version 3 or later <https://www.gnu.org/licenses/agpl-3.0.html>`_.


