DayZ
ZomBerry Admin Tools
 This topic has been pinned, so it's probably important
Vaker  [developer] Dec 9, 2018 @ 4:29pm
How to install & FAQ
Make sure that you have installed CF (Community Framework) by Jacob_Mango, Arkensor and Kegan Hollern on both client and server:
https://steamcommunity.com/sharedfiles/filedetails/?id=1559212036

Video guide:
Huge thanks to Owen for the video!
Note: first part is for those hosting server on their own/dedicated PC, please go to appropriate timecode for GSP installation if you rent a server!
https://www.youtube.com/watch?v=5o2gE0QyNLQ

Note on CF installation:
Keep in mind, CF requires your saves to be wiped before installation. If you want to avoid this, see related section below (it's called I don't want to wipe my server for CF, we've made a lot of things already!)

Obtaining mod files
1. Make sure you're subscribed to CF and ZomBerry in the workshop (links above)
2. Launch DayZ Launcher at least once, wait for it to initialize and update mods on the Mods tab
3. In Steam, right-click on DayZ -> Properties -> Browse
4. If you see !Workshop folder, open it and proceed to step 5
Otherwise, in file explorer: View (W10)/≡ (W11) -> Show -> Hidden items and File name extensions
5. Copy (don't cut!) @CF and @ZomBerry Admin Tools folders

On server (dedicated):
1. Paste mods into the server root (DayZServer folder)
2. If you have a start.bat or a similar file to launch the server, proceed to step 3
Otherwise, create a new text file and call it start.bat (make sure it's .bat, not .bat.txt! Windows should classify it as Windows Batch File, not Text Document)
Edit it using any text editor (preferably Notepad++) and paste the contents for the bat file from here[helpthedeadreturn.wordpress.com]
3. Add Community-Framework and ZomBerry to your server launch options. For example:
"-mod=@CF;@ZomBerry Admin Tools;"
4. Copy Vaker.bikey file from @ZomBerry Admin Tools\Keys into server keys folder (same goes for JacobMango.bikey from @CF\Keys)
5. Launch the server once to generate all necessary files
6. Add your Steam64 UID into <ServerProfilesFolder>\ZomBerry\admins.cfg file, use new line for each admin entry (see explaination below if you don't understand what <ServerProfilesFolder> is), restart the server afterwards


On server (GSP):
1. Try to find Workshop installer and make sure to install both CF (1559212036) and ZomBerry (1582756848)
2. Depending on your hosting provider, you might need to enable mods you just installed using Command line Manager - see if you can find it, and select entry containing workshop mods (it usually has Select button near entries)
3. Launch the server once to generate all necessary files
4. Add your Steam64 UID into <ServerProfilesFolder>\ZomBerry\admins.cfg file, use new line for each admin entry (see explaination below if you don't understand what <ServerProfilesFolder> is), restart the server afterwards
* - this step is done either using File Manager or FTP connection to your server

I don't want to wipe my server for CF, we've made a lot of things already!
There's a server mod that can help you avoid wipes, take it from the links below and make sure to read through README.txt in the archive before proceeding
Make a backup of your save files! These are located inside mpmissions/<mission name>/storage* folder(s)!
Discord invite[discord.gg], message with the server mod archive[discord.com]

List of known default profiles folder locations for popular (and not so popular) GSPs:
Now sorted A-Z! (order doesn't represent quality of service. the only thing it represents is the way letters are arranged in the alphabet. I warned you ¯\_(ツ)_/¯)

4NetPlayers *: profile/ (create/copy on Upload FTP, change on Saves FTP, server MUST BE in stopped state!)
Czech Chillout: instance/
G-Portal: config/ (mod must be loaded as Client mod - it's an equivalent to -mod= launch option)
GTX: SC/
Host Havoc: HostHavocDayZServer/
Nitrado: config/
Ping Perfect: profiles/
ServerBlade: instance/
Spillvert: instance/
Survival Servers: Admin/
ZAP: config/

* - Extended instructions for 4NetPlayers users ONLY (it's a special case, very different from other hosting providers):
https://www.youtube.com/watch?v=dTZFx-BUokI
admins.cfg must be created manually in this case. Make sure it's actually admins.cfg and not admins.cfg.txt. If you end up with admins.cfg.txt and just can not remove the .txt part... upload it anyway and rename in FileZilla or web interface.


What is this <ServerProfilesFolder> (aka *profiles folder*) you're talking about?
Profiles directory is effectively the only folder mods have access to use as much as needed (read, write, append to files, etc.)
ZomBerry and other mods primarily use it to store configuration files.
Path to this location is set on server startup using -profiles= launch option (command line parameter)
It also means that it doesn't have to be named profiles, it can even be named cookies if you wanted to!
Please note, you can only set one such folder (e.g. you can't do this: "-profiles=FolderOne" "-profiles=FolderTwo")
If you have multiple mods using profiles folder, please remember that every mod is using *the same directory*, you don't need (and you shouldn't) specify additional ones!
* GSPs set a default one for your convenience, but it also means you need to find which folder exactly is profiles one. Try searching for -profiles= parameter in Command line Manager if there is one, otherwise open any recent .RPT file in Log Viewer and take a look at first lines, it should contain -profiles=... parameter, you're interested in the ... part. (Note that you're likely to see a full path like C:\Servers\U1337420\256.21.15.128:2302\DayZServer\default - in this case, see if you can find any parts of this structure in your file manager and work what's left from there)
* If you have a LAN (dedicated) server, earlier you added mods to -mod= parameter, now check if -profiles= parameter is not specified, and if it's not, add one, for example: -profiles=ServerProfiles


On client:
Don't forget to enable CF and ZomBerry (Using DayZ Launcher is the easiest option)

Default menu key is O


FAQ
Q: I'm getting some error about pbo file...
A: There might be 2 (3) possible errors containing pbo name:
1. File not found: (pbo file path) - client side problem, mod is not loaded
2. Cannot verify (pbo file).
3. (Same as #2 in terms of debugging) Client contains PBO which is not a part of server data: (pbo file)
2 and 3 are server side problems, which mean that mod is not loaded on server side (make sure that mod folder name is equal to name you put in -mod= parameter/mod list field in your hosting web interface) or/and signature pubkey is not copied over to server keys folder.
Remember - logs are your best friends, enable verbose logging (-dologs or checkbox in web interface), open latest DayZServer_x64_<date-time>.RPT log (should be in profiles directory) and see what actual cmd line parameters are. If any of mod folder names contain spaces, -mod= parameter MUST be quoted (Ex.: "-mod=@Mod 1;@Mod 2;@etc;"), but it must be quoted EXACTLY like in example, one " before the entire parameter, one - after the entire parameter. Some hosting providers are doing this in wrong way (Vi*Layer, for example, is putting " between -mod= and mod list, which is ignored by DayZ argparser)

Q: Server is failing to start with "Unknown type 'CallType'" error
A: CallType enum is defined in CF mod, please make sure that it's installed and loaded on both client and server:
https://steamcommunity.com/sharedfiles/filedetails/?id=1559212036

Q: I can't open admin menu on my server, what should I do?
A: Logs are your best friends. Instead of checking everything in random order, just find script.log file of your client and server. It's always placed in profiles directory, default location (for both client and server) is:
%LocalAppData%\DayZ\
You can change this location using the -profiles= launch parameter. For example,
-profiles=ServerProfiles
will create a ServerProfiles folder right in your server/game root, which makes it easier to find log files and server profile settings
If you're using some kind of gameserver hosting, find info about logs location on their website.
If launch parameter -scrAllowFileWrite is set on your server, most of logs regarding ZomBerry will be redirected to [ServerProfilesFolder]\ZomBerry\ZB_log.txt (only exception is part of debug logs for developers) ZB_log.txt won't be used until write to file fix in DayZ

Q: I found my logs, what should I search for?
A: Find messages containing [ZomBerry], [ZomBerryConfig], [ZomBerryDbg], etc.

If there are no messages about ZomBerry at all, it probably means that ZomBerry isn't even loaded. In this case, check "How to install" section.

[ZomBerryConfig] FATAL: admins.cfg was NOT found, please check previous logs and read FAQ.
Means that ZomBerry was unable to find file containing admins list.
Here is list of locations where ZomBerry would try to find admins.cfg:
  • If -zbryDir launch option was set, ZomBerry will try to find admins.cfg in root of specified directory.
  • Mission directory. In current DayZ version game itself doesn't save correct path to mission folder, that's why you need to modify your mission and help both DayZ and ZomBerry find it. If you wish to use admins.cfg from mission dir, add the line below inside CreateCustomMission method of your mission init.c file. Better examples can be found on GitHub[github.com] (only part 2 is required in this case)
    g_Game.SetMissionPath(path);
  • ZomBerry subfolder of server profiles folder (check first FAQ question for info how to find it)
  • If admins.cfg was not found in any of listed above locations, ZomBerry will try to find it in default addon location ([Server dir]\ZomBerry\Config\), but it's highly recommended to move admins.cfg out of default location (as you might accidentally overwrite it during update process)

[ZomBerryAT] ERROR: ZomBerry version mismatch! C: v0.4, S: v0.3.1, clientside won't start!
Explains itself. ZomBerry ignores minor version mismatches (yet saving it in logs just in case of any issues), but in case of major version mismatch, clientside won't start to prevent any problems it might cause.

Messages about missing config files from [ZomBerryConfig] are not critical, yet config files might be useful to debug custom functions.

Q: I want to change menu key!
A: Sure, you can do that in game settings menu


If you still have any questions, leave a message in this discussion (don't forget to mention DayZ version)
Last edited by Vaker; Jun 1, 2024 @ 3:57am
< >
Showing 16-30 of 213 comments
Vaker  [developer] Dec 14, 2018 @ 9:05am 
Uh, not sure about this one, never experienced this problem :c
Dijin Dec 14, 2018 @ 9:12am 
Ok and no matter what I do and can't get the damn menu to open... I installed just how you said and nothing...
Vaker  [developer] Dec 14, 2018 @ 9:18am 
Have you updated to v0.4.3 on both server and client after DayZ 1.0 release? If yes, check script.log on server, does it contain ZomBerry logs?
Dijin Dec 14, 2018 @ 9:39am 
Yes and I checked the log, nothing about ZomBerry in the log. So what next? :)
Vaker  [developer] Dec 14, 2018 @ 11:05am 
Have you done steps from FAQ question #1?
Dijin Dec 14, 2018 @ 11:09am 
My server is hosted by Vilayer so the mod is installed automatically. I have come to the conclusion that It's client side though becasue when I join your test server nothing happens there either. I just don't know what I'm doing wrong because I am doing exactly what you say to do.
Dijin Dec 14, 2018 @ 11:10am 
I can't get the damn menu to open to save my life...
Vaker  [developer] Dec 14, 2018 @ 12:26pm 
Dijin, nope, your client side is ok:
14.12.2018 21:21:52 (GMT +3) [ZomBerryDbg]: Auth Request ignored (not an admin) Dijin (d8FpE8Wx2hZq+gN6amFLNj8fasbxENOBCMPFWp215Ms=)

Test server is not in everyone-is-admin mode right now, I've even removed it from mod description
Last edited by Vaker; Dec 14, 2018 @ 12:28pm
POLM_GekkeGerrit Dec 15, 2018 @ 10:51am 
Originally posted by Vaker:
Originally posted by POLM_GekkeGerrit:
Steam users:
Copy "@ZomBerry Admin Tools" from client to server root.
Change name of "@ZomBerry Admin Tools" to "ZomBerry" in the server root.
Continue at step 3 of original install instructions.

Shouldn't change very much tho, only difference between Workshop and GitHub versions right now is log handling, in GitHub version all logs are forced to be in script.log, until "Maximum file size exceeded!" issue will be fixed in game

But anyway, I'm glad you found a way to fix your issue :)

Actually it does, you write in the insctructions that the startup param is ZomBerry, but when steam downloads your mod, it calls it @ZomBerry Admin Tools.
Steam users who therefor follow your instructions will not get it to work because of this.
Vaker  [developer] Dec 15, 2018 @ 12:59pm 
Ahh, I got it. Sure, if somebody wants to use workshop version on server, that's the only way to use it, but original instuctions were written to be as easy as it could be, and downloading latest release from GitHub is usually easier than copying it from hidden folder (if we're talking about average users)
=|SAW|=Mexx Dec 16, 2018 @ 6:53am 
get an error with the server start

ZomBerry/AT/scripts/5_Mission/zomberry.c(155): Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,155": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,155": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,190": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,190": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,246": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,246": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,267": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,267": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,295": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,295": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,334": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberry.c,334": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberrymenu.c,523": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberrymenu.c,523": Error in parameters
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberrymenu.c,577": Unknown type 'CallType'
SCRIPT (E): @"ZomBerry/AT/scripts/5_Mission/zomberrymenu.c,577": Error in parameters
SCRIPT (E): Can't compile "Mission" script module!

ZomBerry/AT/scripts/5_Mission/zomberry.c(155): Unknown type 'CallType'
SCRIPT (E): Failed to load mission scripts!
SCRIPT : ~DayZGame()

my_start.bat = start DayZServer_x64.exe -config=@DayzServerCFG.cfg -port=3303 "-profiles=ServerProfiles" -cpuCount=4 -zbryInstallMode=true "-mod=@RPCFramework;@ZomBerry Admin Tools"
Vaker  [developer] Dec 16, 2018 @ 8:06am 
=|SAW|=Mexx, check FAQ, question "After 1.0 release, admin menu doesn't open up OR server is failing to start with "Unknown type 'CallType'" error"
Chinx7🚀 Dec 16, 2018 @ 6:30pm 
When starting the server I get the following popup:

"Compile error"
Can't compile "Mission" script module!
ZomBerry/AT/scripts/5_Mission/zomberry.c(155): Unkown type 'CallType'

I can abort, retry and ignore.

Edit: I just saw the solution is in the FAQ, I'll try it and report back.

Edit2: I tried your solution with the steam workshop, but it doesn't create a workshop folder and there is nothing called RPCFramework on my PC at all, I would appreciate it, if you could upload it somewhere else.
Last edited by Chinx7🚀; Dec 16, 2018 @ 6:45pm
Smok3 Dec 16, 2018 @ 7:17pm 
I installed this but when I hit M key I get this message: Admin auth succeeded, but clientside was disabled due to version mismatch. C: 0.5.0, S: Both my client and server are updated via workshop.
Vaker  [developer] Dec 16, 2018 @ 7:37pm 
Chinx7, !Workshop folder is hidden, but anyway, here is another solution:
  • Open DayZ Launcher
  • Go to Mods tab
  • Select RPCFramework
  • Click on ...
  • Select "Open folder in Windows Explorer"
then just go one level up, copy @RPCFramework and paste it in root of server folder
< >
Showing 16-30 of 213 comments
Per page: 1530 50