Skip to content

Final pre-release

Pre-release
Pre-release
Compare
Choose a tag to compare
@PEMapModder PEMapModder released this 06 Mar 13:01
· 60 commits to master since this release
v1.0-Beta.174
447e2fa

Changelog

API

  • Added HereAuthMultiFactorAuthEvent.

Bug fixes

  • Fixed /unregister.
  • /chpw is now officially supported (tested).
  • /rename is now completed, but not tested. Use with caution.

Miscellaneous

  • Bumped API version. Now explicitly supports the following PocketMine API versions:
    • 1.12.x
    • 1.13.x
    • 2.0.x (the PHP 7 update, required for 0.14.0 onwards)

Unimplemented features

  • Chat masking
    • Disallow players from seeing the chat messages sent to that client from the server/other plugins until authenticated
  • Customized authentication messages for different authentication methods
    • I really thought nobody wanted it 😨
  • Import external databases
    • Actually, the code for importing into memory is already completed.
    • However, I haven't got the time to implement the part of writing imported accounts into HereAuth databases yet.
    • Also, the commands to do so have not been completed either.
    • There is a very likely chance that this process is eventually done through running the entry script of the plugin (opening the phar file with php.exe on Windows, or running php HereAuth.phar on other systems).

Compiling

HereAuth is licensed under the GNU Lesser General Public License version 3. You are welcome to make changes to the plugin under the terms from the license. If you would like to contribute, or just make your own edits, you can clone this repository (or fork it first if you wish to make a pull request) and edit the source code. To compile the plugin so that it can be actually used on a server, you have to run the compile.php file. A fresh new phar build of HereAuth built from the source code you edited will appear/overwrite at compile/HereAuth_Dev.phar. No plugin.yml file is needed, nor would one be ever added directly to the source code.

By the way, the compile.php file comes from the NOWHERE framework by @PEMapModder. It is not an original part of HereAuth.

Should I use this on my server?

There are three types of builds: RC (release candidate), beta and development. A beta build is meant for test servers. If you are running a production server, it's recommended to stay away from these builds. If you really want to use it, please test this build in an environment isolated from your production server (e.g. do not share same database, do not use in same directory, do not open on the same port, etc.) before actually applying it on the production server.

This build, Beta #174, actually already stably covers all features that SimpleAuth offers, as well as other unique features that HereAuth innovated (e.g. data masking), so it is actually stable for production use, theoretically.
However, technically, if any issues occurred during migration from a beta version to another, they are not supported. Migration from an RC to another is supported, but not from a beta/development build and/or to a beta/development build. Therefore, if you do not want to bear the risk of resetting the config file or the database by HereAuth Beta builds, you may want to wait until an RC is published, where migration such as database migration, config migartion, etc. would be supported in the next release.

Nevertheless, this beta build alone is safe to use (but again, test it on a server on a different port and a different database first!). I do not expect more big changes to the config file, so personally I don't think there is the need to wait until an RC is released.

Reporting bugs

Please report bugs to the HereAuth issue tracker on GitHub. I politely ask you not to submit duplicated issues, submit issues for unimplemented features or for questions, or use the issue tracker as a forum. Please also do not start any issues asking why there is no plugin.yml file.

Downloading binaries (phar)

Download the HereAuth_Beta.phar below.

Assets 3