{ "info": { "author": "The NetYeti", "author_email": "thenetyeti@oddotter.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: Public Domain", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 2.7", "Topic :: Games/Entertainment :: Multi-User Dungeons (MUD)" ], "description": "===================\r\ndjangocms-minecraft\r\n===================\r\n\r\nThis is a simple set of plugins intended for use with Django-CMS, designed to aid in retrieving data from the servers.\r\nMuch of this code comes from Dinnerbone's amazing source (..thank you dude!) that he has graciously left as \"fully open\".\r\n\r\nSee the plugins in action here_! \r\n\r\n.. _here: http://www.thenetyeti.com/en/blog/2014/9/4/new-djangocms-minecraft-plugins-version/\r\n\r\nProtocol documentation_ is available as well, thanks to Dinnerbone.\r\n\r\n.. _documentation: http://dinnerbone.com/blog/2011/10/14/minecraft-19-has-rcon-and-query/\r\n\r\nIMPORTANT CHANGES from 0.0.1\r\n----------------------------\r\n\r\nIn 0.0.1 there was an issue with the plugin regarding socket timeout - this has been fixed in 0.1.0 - as well as quite a\r\nfew other additions and changes. However, these changes also resulted in requiring your plugins to be reconfigured in \r\nedit mode after you have migrated the changes into your project from the update. Until you do this, they will be blank.\r\n\r\nINSTALLATION\r\n------------\r\n\r\nInstall with pip:\r\n\r\n``pip install djangocms-minecraft``\r\n \r\nOr, optionally, install the development version:\r\n \r\n``pip install git+https://git@bitbucket.org/oddotterco/djangocms-minecraft.git#egg=djangocms-minecraft``\r\n\r\nThen, in your project's settings.py file, add 'djangocms_minecraft' to the INSTALLED_APPS like so:\r\n\r\n``INSTALLED_APPS += ('djangocms_minecraft',)``\r\n \r\nFinally, perform syncdb and migrate on your project, as well as collectstatic to get all the supplied css and images\r\nfor this plugin.\r\n\r\nA note on CACHEing\r\n~~~~~~~~~~~~~~~~~~\r\n\r\nIt is recommended that you configure caching on your server when using this plugin (and in general, really). It really\r\nis not too complicated to set up basic caching. The following is a *very basic* config example, just add it to your\r\nsettings.py project file to use your existing database backend as a cache server as well.::\r\n\r\n # Enable plugin and content caching\r\n # Don't forget to: ./manage.py createcachetable cache_data\r\n CACHES = {\r\n 'default': {\r\n 'BACKEND': 'django.core.cache.backends.db.DatabaseCache',\r\n 'LOCATION': 'cache_data',\r\n },\r\n }\r\n\r\nMinecraft Server Config\r\n~~~~~~~~~~~~~~~~~~~~~~~\r\n\r\nDon't forget to make sure that your web server has access to the ports that your Minecraft server is going to be\r\nanswering these queries on. Typically this will be the same as the Minecraft game port (which is default 25565) for the\r\nstatus, query and plugins-list plugins. For the RCON plugins, make sure that port (default is usually 25575) is open to\r\nthe web server from the game server as well. Also, for all but the basic status plugin, you will need to configure the\r\ninecraft server to enable those services. Query and RCON are both off by default (). Look for details in the\r\ninecraft `Server.properties`_ wiki entry.\r\n\r\n.. _Server.properties: http://minecraft.gamepedia.com/Server.properties\r\n\r\nUSAGE\r\n-----\r\n\r\nSimply add the plugins to pages as desired. They will show up in both a text plugin's plugins-list as well as the\r\npage plugins-list, under the header \"Minecraft\".\r\n\r\nAlso included, for your use, is the commandline client provided by Dinnerbone. To use it, simply issue the command\r\n``mcquery`` and help-text will guide you. Typical usage might be ``mcquery my_minecraft.server.net``. Keep in mind that\r\nthe Minecraft server port needs to be accessible by the client issuing the command, *and* for the full query response,\r\nyou will also need to enable query mode on your Minecraft server.\r\n\r\nSUPPORT\r\n-------\r\n\r\nIf you have questions or ideas, or encounter bugs, add an entry to our\r\n`issue tracker`_.\r\n\r\n.. _issue tracker: https://bitbucket.org/oddotterco/djangocms-minecraft/issues\r\n\r\n\r\nLICENSE\r\n-------\r\n\r\nPublic domain - do what you will with this code. Drop a line and let me know it helped you.\r\n\r\nAs with Dinerbone's original code - Fully open. Go wild. Let us know what you do with it and PLEASE feel free to fork_\r\nand pull-request!\r\n\r\n.. _fork: https://bitbucket.org/oddotterco/djangocms-minecraft/fork\r\n\r\n\r\nCHANGELOG\r\n---------\r\n\r\n* v0.2.1 2014/Sep/01\r\n * Changed Minecraft host field to character, not IP. Some users were reporting the need for standard domain names.\r\n * Added missing migration files to uploaded version.\r\n* v0.2.0 2014/Sep/01\r\n * Added caching to server info to speed up rendering if cache is enabled and configured.\r\n * Added 'mcquery' entry_point to the cli.py command utility from Dinnerbone\r\n * Many small fixes and cleanup, as well as some commenting and documentation\r\n* v0.1.0 2014/Aug/28\r\n * Fixed timeout issues when server was not available\r\n * Reduced to one servers list table for all plugins\r\n * Cleaned up templates and added example graphics\r\n * Added human readable field names and help text to server models\r\n* v0.0.1 2014/Aug/25\r\n * PEP version number conflicts resolved\r\n* v0.0.1a1 2014/Aug/25\r\n * Initial release\r\n\r\nFURTHER IDEAS\r\n-------------\r\n\r\nWhat is next? Here are the ideas for the moment. Please feel free to join in on this list - just create an issue_ and\r\nmark it as a *proposal*. Be as specific as you can.\r\n\r\n.. _issue: https://bitbucket.org/oddotterco/djangocms-minecraft/issues/new\r\n\r\nDocs\r\n~~~~\r\n\r\n* Configuration tips, dos and dont's doc for new users (include info about security issues with enabling query) Use wiki?\r\n\r\nCore\r\n~~~~\r\n\r\n* Make the servers list reusable so that a user does not have to re-enter the server info - reduces error potential of\r\n bad data over multiple plugins pointing at the same server.\r\n* Make server timeout configurable (use livesettings or store per-server?)\r\n* Optional, configurable and RESTful JSON API for external consumers\r\n\r\nQuery-Plugins\r\n~~~~~~~~~~~~~\r\n\r\n* Autocheck for dynmap plugin before offering to link the map in full_status plugin?\r\n* Javascript option to auto-update the status on a page without refreshing\r\n* Use the specific Minecraft server icon as the \"server up\" image if there is one\r\n\r\nRCON-Plugins\r\n~~~~~~~~~~~~\r\n\r\n* Add RCON support (whitelist, reload, etc)\r\n* Help page plugin that populates using rcon\r\n* Auto-check for supported plugins and offer RCON support as each becomes supported and available\r\n* add entry-point for rcon command (mcrcon)\r\n\r\nAUTHORS\r\n-------\r\n\r\n* The NetYeti ", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://bitbucket.org/oddotterco/djangocms-minecraft", "keywords": "django,cms,minecraft", "license": "UNKNOWN", "maintainer": "", "maintainer_email": "", "name": "djangocms-minecraft", "package_url": "https://pypi.org/project/djangocms-minecraft/", "platform": "Linux", "project_url": "https://pypi.org/project/djangocms-minecraft/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://bitbucket.org/oddotterco/djangocms-minecraft" }, "release_url": "https://pypi.org/project/djangocms-minecraft/0.2.1/", "requires_dist": null, "requires_python": null, "summary": "A set of Django plugins that will display live Minecraft server status and information within your project.", "version": "0.2.1" }, "last_serial": 1325045, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "f9a08156167eeb887bd102793fd1142c", "sha256": "96ed095e01a4140ce8c25b2f43ee75b8690c8280271943949fd7f0ed6858ba04" }, "downloads": -1, "filename": "djangocms-minecraft-0.0.1.tar.gz", "has_sig": false, "md5_digest": "f9a08156167eeb887bd102793fd1142c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12417, "upload_time": "2014-08-25T12:36:58", "url": "https://files.pythonhosted.org/packages/f6/94/32b5f4959e8cdd4fd49f4845d6eb919ba02206d38af9257394bc0b0dddd4/djangocms-minecraft-0.0.1.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "81e2667f0e7dd5e0871f6ec8382ee106", "sha256": "42471cfdb2357dd98d1bf0282bb6f7e8ce56955c51483b6967fee1b71a331403" }, "downloads": -1, "filename": "djangocms-minecraft-0.1.0.tar.gz", "has_sig": false, "md5_digest": "81e2667f0e7dd5e0871f6ec8382ee106", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19491, "upload_time": "2014-08-28T16:46:47", "url": "https://files.pythonhosted.org/packages/7a/11/9abbb7aa783c87facc757030f4f2d68b0e1412ca0936790d569cf0d39dbd/djangocms-minecraft-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "54e5064fd78c6b9c94494d2806a6488d", "sha256": "a26fd18394b510a4a65cdd74e255f5ee4a4354125a0117c5138cdad0a7801e50" }, "downloads": -1, "filename": "djangocms-minecraft-0.2.0.tar.gz", "has_sig": false, "md5_digest": "54e5064fd78c6b9c94494d2806a6488d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23871, "upload_time": "2014-09-02T00:18:45", "url": "https://files.pythonhosted.org/packages/b3/92/9d71ceeb390f169be78994519f55150252ca3aa4622098333c8ce8c8a8db/djangocms-minecraft-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "8d560e33ce4172a442876058c893081c", "sha256": "b02662505f61bf5a120f8a2c4bc3c7c67aee6f7f17d11a0b563ebdfbaab8a61c" }, "downloads": -1, "filename": "djangocms-minecraft-0.2.1.tar.gz", "has_sig": false, "md5_digest": "8d560e33ce4172a442876058c893081c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24351, "upload_time": "2014-09-02T00:56:09", "url": "https://files.pythonhosted.org/packages/d3/fd/a0fc1e7bc7a06ee5815d20b761417c88ae2d115674fc0a76e3ba05806f06/djangocms-minecraft-0.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8d560e33ce4172a442876058c893081c", "sha256": "b02662505f61bf5a120f8a2c4bc3c7c67aee6f7f17d11a0b563ebdfbaab8a61c" }, "downloads": -1, "filename": "djangocms-minecraft-0.2.1.tar.gz", "has_sig": false, "md5_digest": "8d560e33ce4172a442876058c893081c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24351, "upload_time": "2014-09-02T00:56:09", "url": "https://files.pythonhosted.org/packages/d3/fd/a0fc1e7bc7a06ee5815d20b761417c88ae2d115674fc0a76e3ba05806f06/djangocms-minecraft-0.2.1.tar.gz" } ] }