[WEB/ADMN] - Webukkit v0.beta9.5-fix3

Discussion in 'Bukkit Tools' started by cyberbobjr, Feb 12, 2011.

Thread Status:
Not open for further replies.
  1. Offline


    Version: v0.9.5-fix3
    Webukkit is a http interface for Bukkit.

    • Stats pages : top 10 builders, killers, travelers, etc. based on the Stats Plugin
    • GUI Plugins (see screenshots) for :
      • Permissions plugin
      • Achievements plugins
    • Show a map of your world (with an url like dynmap or a image file like mcmap)
    • Show/modify/backup your plugins configuration files
    • Access to some commands of TCP Plugin (http://forums.bukkit.org/threads/admin-dev-tcp-interface-for-bukkit-v1-1-297.746/) :
      • Send a message to a connected player
      • Send a message to all players connected
      • Kick a player
      • Display player's inventory
      • Destroy an item in the player's inventory
      • Give item to a player
    • Access to Remote Toolkit Plugin (http://forums.bukkit.org/threads/ad...view-full-remote-console-access-r10-a7-1.674/) :
      • Restart server
      • Restart forced server
      • Stop server
      • Stop Minecraft server
      • Start Minecraft server
      • Send console command and watch the result (ban, kick, op, deop, deban, etc.)
    • Interaction with Permissions plugin : allows users to register and be automatically listed in the Permissions plugin with a choosen world and a choosen group
    • Access to the server log
    • Theme support, you can made your own theme ! (Minecraft theme is provided, see screenshots)
    • Permissions for the website : ability to access map & stats pages for public/registered users
    Planned/Todo :

    - Edit profile for users : add avatar option for stats pages - (not started yet, planned for the 1.0)
    - Signature generator : make signature with player's stats - (not started yet, planned for the 1.0)
    - GUI for GroupManager : i'm waiting for the YAML fix or for the SQLite version of GM...
    - Mini blog engine : add posts and comments in the Public interface (not started yet, maybe for the 1.0 version)
    - Replace TCP Remote Plugin by my own plugin : RemoteTCP (http://forums.bukkit.org/threads/dev-remotetcp-v1-0-crypted-server-query-602.10506/), more secure, more faster.


    You will need :
    • HTTP server with mod_rewrite support
    • MySQL 5
    • PHP 5.2 or greater (or PHP 5 but with json package)
    Download (open)

    You can download the archive here : http://code.google.com/p/bukkit-webadmin/downloads/list

    You can access the source code here : http://code.google.com/p/bukkit-webadmin/source/checkout

    Screenshots (open)

    Webukkit permissions (Theme : minecraft)
    Gui for Achievements (Theme : minecraft)
    Stats page (with Stats plugin) (Theme : minecraft)
    Installation Windows
    Connexion Windows
    Configuration Windows
    Map Windows (with dynmap)
    Map Windows (with integrated viewer - mcmap example)
    Log Windows
    Plugin Editor Windows
    Status Windows : Server command & Player command & Player inventory
    GUI for Permissions plugin

    Installation (open)

    A tutorial was write for installation, look at this : Tutorial step 1

    You must have an HTTP server AND a MySQL base AND PHP Version >5.2 (for json thanks to zajacmp3 ;))
    1. Unzip the archive in your html root folder.
    2. Go to http://yourserver/index.php/installer/ and follow instructions.
    Linux Users, attention :
    • The files unzipped must be owned by the apache group !
    • If you want to modify config file for plugins, the minecraft directory must be writable by the apache group !
    Install these scripts to the same server that host Minecraft if you want to edit config files of plugins.

    If you want to use TCP Bukkit Interface, it's must be configured with this option :

    Upgrade to 0.7 (open)

    From 0.5beta : please don't do an upgrade with the 0.5beta, it's better to do a fresh install.
    From 0.6beta : is not necessary, uncompress the 0.7beta archive and run it's enough.

    Instructions :

    1. Unzip the archive into your Bukkit Webadmin directory (be careful to the rights)
    2. Go to http//yourserver/updater and generate the tables you don't have.

    Interaction with Permissions plugin (open)

    I've tested this functionnality with Permissions Plugin 2.1.
    Be carefull : do a backup of your config file "yml" before.

    This functionnality let your users to register on the site and automaticaly be added to the Permissions Plugin.
    You choose the default group and default world for new users.
    This functionnality is not mandatory, it's an option, you can choose to activate it or not.

    For enabling this functionnality, go in the config menu, check "Use Permissions plugin" and choose the default world and default group. The group list is calculated dynamically on the configuration file of Permissions plugin.

    Each time a user registers on the site, a new entry is added into config "yml" file of Permissions plugins. If you use the Nukkit plugin (http://forums.bukkit.org/threads/ad...-web-based-authentication-and-promotion.4631/) the permissions will be automatically reloaded, if not you must reload manually configuration of Permissions plugin.
    If you want to reload automatically permissions plugins, click on the chekbox "Reload permissions after new register ?" (warning it's experimental). You must have RemoteToolkit Plugin enabled and correctly configured.

    How to made your own theme (open)

    Theme files must be in the directory /theme
    The name of the directory will be the name of your theme, it will be visible in the config menu.
    In your theme directory, make CSS and IMG directory.
    Inside CSS, put your ... CSS files :) You must have 3 CSS :
    • "default.css" - General CSS for the website
    • "jquery-ui-1.8.9.custom.css" - You can generate CSS at this url : http://jqueryui.com/themeroller/
    • "selectmenu.css" - CSS for the dropdown langage selector
    Inside IMG, put all images files necessary for your theme.

    For example, you want to design a theme called "NochtheBest".
    Create a directory named "NochtheBest" in "Theme" directory.
    Create a CSS and IMG in "NochtheBest", copy your CSS and IMG files inside them.
    You will have :
    \ - Theme
    \ - NotchtheBest​
    \ - CSS​
    \ - IMG​

    Done! You can change your theme in the config menu to "NotchtheBest"

    Changelog (open)

    version 0.9.5-fix3 - 2011-04-16
    • Fix a bug with achievement editor
    • Fix a bug for the path of items.txt
    version 0.9.5-fix2 - 2011-04-14
    • Fix for Stats & Achievements v0.9
    version 0.9.5-fix1 - 2011-03-22
    • Remove test menu :p
    version 0.9.5 - 2011-03-21
    • Add SQL support for Stats & Achievements plugin
    • Add support for Stats & Achievements plugin v0.8
    • Fix a bug for a trailing slash in the main root url
    • Add singlequote instead of doublequote for YAML config file
    version 0.beta9 - 2011-03-13
    • Add theme support
    • Add permissions for website (for stats & map)
    • Add stats pages (with Stats plugin)
    • Add group and user management for webukkit
    • Add GUI for Achievements plugin
    • Add an option for reloading Permissions plugin when a user is registered (experimental)
    • Full french translation
    version 0.beta8 - 2011-03-11
    • Add a php version check for the installer
    • Add a langage selector (French is translated "petit à petit") - Thanks to Amrac !
    • Add a GUI for Permissions plugins
    • Modify the registration system for new users into Permissions plugins, add the world option
    • Fix a bug with trailing slash in the minecraft path
    • Fix a bug in core.php for the UTC time zone
    Version 0.beta7 - 2011-03-01
    • The name is now "Webukkit" instead of "Webadmin Bukkit"
    • Subdirectory feature : you can now install Webukkit in a subdirectory instead of a root web directory
    • Add an edit button for editing template plugin
    • Fix a bug images displayed in inventory when you use subdirectory
    • Add a log windows : now you can see the log server.
    • You can send command to the console in the "log" menu (be careful it's experimental, use it at your own risk).
    • Add another map system, you can now use a standard image file for displaying map instead of a url for dynmap (the image file must be stored in /maps/images)
    • Ajax request don't block the windows now, a simple "wait cursor" is now displayed when an Ajax request is made
    Version 0.beta6 - 0211-02-24
    • Fix a bug when the plugin name contain a space, the plugin tab did not display the config file.
    • In the installer, you can now choose if you want to create a database or use a existing one, you can also set the prefix for tables.
    • You don't need anymore to be root of the database for creating tables and inject data, a valid account with privilege is enough.
    • Add licence information
    • Add "hold" and "unhold" command for Remote toolkit
    • Automaticaly add registered users to Permissions Plugin with a default choosen group (it's an option, you can uncheck this feature if you want)
    • Add some verifications check in the register panel
    • Add user management in the config tab
    • Add a button in the 'Edit plugin' menu for deleting old config file
    • Add new items from the Minecraft 1.3 version
    Version 0.beta5 - 2011-02-21
    • Remove the rewriting process, no more .htaccess !
    • Major change in directories structures
    • Add a user registration (for later)
    • Various minors fixes and checks
    Version 0.beta4 - 2011-02-18
    • Add Remote toolkit support (it's now possible to restart the server)
    • Add UTF-8 support for config file (Gastronomic plugin for example)
    • During the update it is now possible to import new templates plugins
    • During the installation, the "tmp" directory AND subdirectories are write-checked
    • CSS cleaning
    • Remove some useless function (the status windows display faster now)
    • Windows in the inventory panel are moveable
    • All always, some minors bugs fixed
    Version 0.beta3 - 2011-02-16
    • Add inventory management
    • Change the status windows
    • Add a check for installation for security (if a file exist, you can't install anymore)
    • Add an updater processus
    Version 0.beta2 - fix 2
    • Add verification of permissions in the installer process and the config process.
    Version 0.beta2 - fix 1
    • Many littles fixes for Linux system
    Version 0.beta2
    • First release to the public

    0.beta9.5 is still free, but you can donate.

    v1.0 will cost 5€ when it will be done.


    PS : sorry for my bad English, i'm a French native ;)

    Thanks to MonsieurApple for his Minelink PHP Class (http://forums.bukkit.org/threads/minelink-0-1.3564/)

    Tested on :
    Windows 7 - Xampp 1.7.3
    Windows XP - Xampp 1.7.3
    Linux ClearOS 5.1 - Apache/PHP 5/MySQL 5.2
    Centos 5.3 - You must upgrade PHP to 5.2 => http://wiki.centos.org/HowTos/PHP_5.1_To_5.2

    Tested with :
    CraftBukkit build 617
    Permissions plugin 2.5.4
    TCP Plugins 1.2
    Remote Toolkit plugin r10 a8.2
    Stats & Achievements v0.9
  2. Offline


    Is in project, in the next version you will be able to choose what users can see in the default page.
    I have a lot of ideas :
    - Map button
    - Stats pages (achievements & stats plugins)
    - Blog engine
    - Offline viewer for player's inventory
    - Signature generator

    Thank for the tip, i'll add it by default in the next version.
  3. Offline


    Nice new version, love where this is going :)

    Quick bug report about your YAML parser:

    My permissions file is formatted like this (exemplary)

      permissions: {system: default, copies: []}
        default: true
        info: {prefix: '&f[Visitor&f] ', suffix: null, build: false}
        inheritance: []
        permissions: [/manreload, worldedit.navigation.unstuck, worldedit.navigation.ascend,
          worldedit.navigation.descend, essentials.spawn, jail.usercmd.jailstatus, multiverse.tp,
        default: false
        info: {prefix: '&f[Guest&f] ', suffix: null, build: true}
        inheritance: [Visitor]
        permissions: [essentials.msg, essentials.spawn, essentials.list, essentials.kit,
    When I edit the permissions file with the GUI of Webukkit, it reformats it to this (exemplary)

        [-snip- blahblah]
           - essentials.msg
           - essentials.spawn
           - 'essentials.kit.*'
           - essentials.mail
    As you can see, it only adds the needed ' ' around the command with the *, but not the others, which causes BAD errors once you reload the permissions. The parser would have to put a ' ' around every node after the -

    Just saying this here in case you get reports by people complaining your plugin breaks permissions ;)
  4. Offline


    Thanks for the report, i'll fix it. YAML is really hard to implement in PHP, libraries were rare and often incomplete.
    I've tested permissions but i don't have this BAD errors even without quotes... I use Permissions plugins v2.5.4 and you ?
  5. Offline


    Does this have to be hosted on the same server mc is hosted on?
  6. Offline


    If you want to :
    - Edit plugins config file
    - use GUI Permissions plugin
    - display a map (like mcmap)
    The answer is yes.

    If you just want to use :
    - Tcp Plugin
    - Remote Toolkit plugin
    - display a map (like dynmap)
    The answer is no
  7. Offline


    Can i edit peoples inventory and do bans etc without having it on the same server?
  8. Offline


    Yes you can if you have installed TCP Plugins and Remote Toolkit plugin.
  9. Offline


    Erm, I have it installed and everything. But how do I manage users like add admin accounts etc? Because i cant figure out how to have more then 1 admin account on the acp
  10. Offline


    What is "acp" please ?
  11. Offline


    acp means admin control panel...
  12. Offline


    You can't add or modify admin account for the moment. In the version 0.9 (release soon), i have added some functionnality for managing permissions in Webukkit.
  13. Offline


    Could you add the feature, that after editing the world.yml (from permissions) it sends the command "permissions -reload all" to the console ? Cause I've to run this command everytime a user registers manually
  14. Offline


    Good idea, i'll implement it.
  15. Offline


    Hi Guys,
    somes news in the 0.9 version :
    - Added : theme support, i have made a new theme, you can made your own theme too !
    New theme (open)


    - Stats & Achievements support
    - Better multilanguage support
    - GUI for Achievements plugin
    - Permissions for Webukkit
    Permissions for Webukkit (open)


    - You can give a name to the site instead of "Webukkit"

    I hope to release this new version in the end of the week. (I you want it now, please donate and i'll give you the archive before ;))
    I need to add these functionnality :
    - Achievements presentation page for public/registered/admin users

    Hi MrSpider,
    Done in the 0.9version.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 8, 2016
  16. Offline


  17. Offline


    Hi GmK,
    I've tested and you're right, the file format is modify, but it still in the YAML format. I don't see an error in Yeditor. Please can you give me your error ?
    Thanks you.
  18. Offline


    As I wrote above (http://forums.bukkit.org/threads/web-admn-webukkit-v0-beta8.4141/page-9#post-123998), SPYC doesnt manage to convert the format *back* properly, so it is no problem to use yeditor ingame, but when you edit the file with Webukkit, it converts it back wrongly, giving you a broken permissions file which causes errors. It is a problem with spyc and nothing you can do probably :(
  19. Offline


    I'm interested to know this error because i don't have an error. Please can you give me the output of error ?
    If you can send me before/after permissions files too it will be nice :)
    Thank you very much.
    For SpyC, i can rewrite or fix some code inside it.
  20. Offline


    Hi !! New version is awesome !! I like new features (Stats&achievements, themes, reload permissions,...). Between your Webukkit (what the real name ???) and bukkitadmin by MrApple mon coeur balance [​IMG]

    I have one problem and one question :
    - first, question : did you plan to add compatibility with sql version of stats&achievements (actually my stats database sql is not found because it look for stats.db) ?
    - second, problem with permissions GUI, as it was already reported. it doesn't put '' when I leave blank. some plugins needs to have '' . example for essentials chat plugin (I believe), if Prefix is set it will search for suffix and spam error [WARNING] Missing a prefix or suffix for Admins if there is not a ''. That why I have to edit manually the world.yml file...

    Thanks you very much for all your great stuff [​IMG]
  21. Offline


    Hi dragonhib,
    Thanks for your support :)

    Yes, i'm work on it.

    Yaml is really a problem in PHP. I think to resolve definitely by use spyc for reading, and i'll made my own routine for writing. Writing is more easy to code than reading.
    I'll do it for the 0.9.5version
    Maybe tonight or monday (this week-end i'll do a break ;))
  22. Offline


    EhEh !! Everything you say is really good !! then I just have to wait for next release [​IMG]
  23. Offline


    Yeah, the next release will fix that.
    I want to develop other tools : plugins for Joomla or/and Wordpress. Who is interested ?
  24. Offline


    It's a good idea. I am very interested [​IMG]
  25. Offline


    Good news ! You can apply this fix and you'll have the quotes in the yml files :) :
    In /app/controllers/components/spyc.php
    At line 66, change :
      public $setting_dump_force_quotes false;
      public $setting_dump_force_quotes true;
    And you'll have a correct YML :)
  26. Offline


    Works great !! Thanks you very much !! It was very unconfortable [​IMG]
  27. Offline



    Thanks for the idea how to fix it, unfortunately it doesnt solve the problem ;)

    When setting the force quotes to true, it does indeed parse the file a little better, but still wrong (not correct YML to be read by Permissions). Example of what it looks after I edited my permissions with Webukkit:

        default: true
          prefix: '&f[Visitor&f] '
          build: false
        inheritance: [ ]
          - "epiczones.spawn.enter"
          - "epiczones.guest.build"
          - "epiczones.guest.destroy"
          - 'mcdocs.*'
          - "mcdocs./apply"
    It would need single ' instead of the " (as it does it with the * permissions node). And this is causing a lot of stacktraces again.
  28. Offline


    Hi GmK,
    I'll work on this monday. You'll have single quote instead double quote, promise :)
    If you want this now, you can modify spyc.php at about line 380.
    Replace :
    $value '"' $value '"';
    $value '\'' $value '\'';

    stats & achievements plugins has change the data folder with the SQLite file.
    I'll publish a new revision of 0.9beta with this modification.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 8, 2016
  29. Offline


    Hi guys,
    Some news : i'll change for a new job in a few days. This is why i fear not to be able to update Webukkit as often as now.
    I'm working on several new projects too :
    The next craft project, a french dedicated server which the purpose is to reborn the T4C mmo with Minecraft (http://www.thencraft.com/)
    Plugins for Joomla/Wordpress.
    I have a personal Minecraft server project : "Romulus & Remus", or the born of the Roman Empire.
    I'll keep Webukkit updated and functionnal with severals plugins, but the dev will be slower.
  30. Offline


    I'm attempting to install this with WAMP instead of XAMPP, as that's what I already run for my web server. When WeBukkit tries to check the config, it gives me the "Please Wait..." message, but nothing ever happens. Any idea what could be going on? PHP, MySQL, and Apache are all up to date.
  31. Offline


    can you set debug level to 1 in /app/config/core.php and give me the output please ?
Thread Status:
Not open for further replies.

Share This Page