[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


    Hi everyone-

    If you like this wonderful piece of software, you might also happen to like BukkitAdmin :)
  3. Offline


    Ok men, "je rends les armes" :) maybe i've found the solution, but not fully tested :
    In cake/dispatcher.php
    at about line 361
    search for :
            if (!empty($base)) {
                if (
    strpos($this->webroot$dir) === false) {
    $this->webroot .= $dir '/' ;
    and replace by :
            if (!empty($base)) {
                if (
    strpos($this->webroot$dir) === false) {
    $this->webroot .= '/' ;

    And you could use subdirectory.
    But i'm not fully tested this patch, please be carefull, and tell me if all was good.
    Thanks you very much
  4. Offline


    You can do for this video guide?!
    I dont understand nothing!
  5. Offline


    For what ?
  6. Offline


    do to video how to build this webadmin..its will help to lot of pepole!
  7. Offline


    I agree,I can set up the databases but i cant find or set the plugins or it to connect to the server, i use xammp
  8. Offline


    You have made the hardiest part :)
    After installation, if you can connect to the main login interface it's win.
    Login with admin/admin and click on the admin menu.
    Next click on the config menu.
    On the config tab, you can indicate where is your minecraft (in this case it must be on the same server than the HTTP server), if you want to use TCP Plugin, etc.
    In the plugins tab, you'll see some default plugin i've created, you can add your own plugin.

    I'll do a step by step tutorial today, and MAYBE a video :)
  9. Offline


    there is name url and config what or whereto find this?
  10. Offline


    The "name" must be the same name than the plugin name (it's case sensitive) without .jar extension.
    "URL" is useless, just for info.
    "config" is where the config file of the plugin is stored.

    I take an example :
    My minecraft server is on my linux box ( in /usr/minecraft
    I've installed the Webukkit on the same box ( in /var/www/html
    After installation anf configuration, i can now connect to Webukkit with this url :
    In the config panel, i have these parameters :
    Show Spoiler


    By default, in the plugin tab of the config menu (these are the plugins defined by me and present in the distribution) :
    Show Spoiler


    For example, "BukkitTcpServer" plugin.
    The plugin TCP interface is located at /usr/minecraft/plugins/BukkitTcpServer.jar
    The plugin TCP interface use a config file named "BukkitTcpServer.properties", this config file is located here :

    That's why in the plugins tab, i have :
    Name : BukkitTcpServer (the filename without .jar extension, it's case sensitive too)
    Path to config file : BukkitTcpServer.properties (because the path is relative to the main minecraft path, see the "Config" tab)

    Now if we go to the "Edit Plugin" menu, we have :
    Show Spoiler


    Webukkit automatically detect which plugins are installed and show the config file for each. The detection routine is based on information we have enter before (in the config menu => plugins tab).

    Hope that i have answer to your questions.
  11. Offline


    I put name Essentials

    url none

    config: D:\minecraft\server craft craftbukkit\plugins\Essentials\config.yml

    Keeps at please wait,mouse cursor keeps going round

    Btw i use windows 7 x64
  12. Offline


    It's not good, the config must be relative to the minecraft path, in your case :
  13. Offline


  14. Offline


    No, check the plugins already declared (see the plugins table)!
    The config file you must write is : /plugins/Essentials/config.yml

    (for info : a path is not an url, and vice-versa)
  15. Offline


    My site looks like this, what can I do?
  16. Offline


    You have put Webukkit in a subdirectory ? if yes :
    In cake/dispatcher.php
    at about line 361
    search for :
            if (!empty($base)) {
                if (
    strpos($this->webroot$dir) === false) {
    $this->webroot .= $dir '/' ;
    and replace by :
            if (!empty($base)) {
                if (
    strpos($this->webroot$dir) === false) {
    $this->webroot .= '/' ;

  17. Offline


    Any reason for a 500 internal server error ?
  18. Offline


    No reason, what is your http server ? on which system ? where did you install Webukkit ? and what is the url of access ?
  19. Offline


    It works. Thank you!
  20. Offline


    permissions 2.1 doesn't use the file config.yml anymore, we're supposed to dirrectly name it according to our world. However it seems Webukkit is looking for config.yml, any fix for this?
  21. Offline


    hmmm... i must look for that [​IMG]
    thank for the info.

    Hi friends,
    i've write this tutorial for the first steps of installation/configuration of Webukkit :

    yeah, finally i've understand how it's work.
    But no need for a fix, you can modify easily yourseft, because the plugin management inside Webukkit is open:
    - First go to menu "config", tab "plugins"
    - Click on the cross to the right of the line "Permissions" for deleting the plugin
    - Next, click on the "+" button above the table, you can re-add the plugin with your parameters :
    • Name : Permissions
    • URL : not necessary
    • Config : type the path to the name of the new config file (i.e. : /plugins/Permissions/world.yml)
    Save, and it's done :) The registered users will be saved in the world.yml.
    Edit : in the next version you will be able to edit instead of delete/create.

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


  23. Offline


    Going to drmc2.tk/index2.php/updater doesn't work for me.
  24. Offline


    Hi ! I follow this tuto : http://code.google.com/p/bukkit-webadmin/wiki/TutorialStep1

    But when you say to click on the Config tab, you got this : [​IMG]

    But i got this ... : [​IMG]

    What i do here ? o.o

    Thank you !

    EDIT: Ho ! i was on Explorer and not Firefox ... Can you fix this for other users ? :3 Ty !
  25. Offline


    I am also getting this, ive done it on 3 computers, and i'd like to consider myself adequately informed about setting up, managing, and administering a webserver.
  26. Offline


    please can you try this :
    in /app/config/core.php
    modify :
    and give the error displayed please ?
    thanks you very much
  27. Offline


    Absolutely, ill try that now and let you know what happens.
  28. Offline


    all the plugins are empty
  29. Offline


    It's maybe the minecraft path is not good.
    Please, ca you give the minecraft path you use ? and what you have declared in Webukkit ?
  30. Offline


    I got the same i dont even get to the path with minecraft i directly get to the name url and config
  31. Offline


    Use Firefox or Google Chrome for the moment, i'll check with IE when i'll have more time.
Thread Status:
Not open for further replies.

Share This Page