]> git.lizzy.rs Git - minetest.git/blob - src/server.h
Add server side ncurses terminal
[minetest.git] / src / server.h
1 /*
2 Minetest
3 Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as published by
7 the Free Software Foundation; either version 2.1 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 GNU Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18 */
19
20 #ifndef SERVER_HEADER
21 #define SERVER_HEADER
22
23 #include "network/connection.h"
24 #include "irr_v3d.h"
25 #include "map.h"
26 #include "hud.h"
27 #include "gamedef.h"
28 #include "serialization.h" // For SER_FMT_VER_INVALID
29 #include "mods.h"
30 #include "inventorymanager.h"
31 #include "subgame.h"
32 #include "util/numeric.h"
33 #include "util/thread.h"
34 #include "environment.h"
35 #include "chat_interface.h"
36 #include "clientiface.h"
37 #include "network/networkpacket.h"
38 #include <string>
39 #include <list>
40 #include <map>
41 #include <vector>
42
43 #define PP(x) "("<<(x).X<<","<<(x).Y<<","<<(x).Z<<")"
44
45 class IWritableItemDefManager;
46 class IWritableNodeDefManager;
47 class IWritableCraftDefManager;
48 class BanManager;
49 class EventManager;
50 class Inventory;
51 class Player;
52 class PlayerSAO;
53 class IRollbackManager;
54 struct RollbackAction;
55 class EmergeManager;
56 class GameScripting;
57 class ServerEnvironment;
58 struct SimpleSoundSpec;
59 class ServerThread;
60
61 enum ClientDeletionReason {
62         CDR_LEAVE,
63         CDR_TIMEOUT,
64         CDR_DENY
65 };
66
67 class MapEditEventIgnorer
68 {
69 public:
70         MapEditEventIgnorer(bool *flag):
71                 m_flag(flag)
72         {
73                 if(*m_flag == false)
74                         *m_flag = true;
75                 else
76                         m_flag = NULL;
77         }
78
79         ~MapEditEventIgnorer()
80         {
81                 if(m_flag)
82                 {
83                         assert(*m_flag);
84                         *m_flag = false;
85                 }
86         }
87
88 private:
89         bool *m_flag;
90 };
91
92 class MapEditEventAreaIgnorer
93 {
94 public:
95         MapEditEventAreaIgnorer(VoxelArea *ignorevariable, const VoxelArea &a):
96                 m_ignorevariable(ignorevariable)
97         {
98                 if(m_ignorevariable->getVolume() == 0)
99                         *m_ignorevariable = a;
100                 else
101                         m_ignorevariable = NULL;
102         }
103
104         ~MapEditEventAreaIgnorer()
105         {
106                 if(m_ignorevariable)
107                 {
108                         assert(m_ignorevariable->getVolume() != 0);
109                         *m_ignorevariable = VoxelArea();
110                 }
111         }
112
113 private:
114         VoxelArea *m_ignorevariable;
115 };
116
117 struct MediaInfo
118 {
119         std::string path;
120         std::string sha1_digest;
121
122         MediaInfo(const std::string &path_="",
123                   const std::string &sha1_digest_=""):
124                 path(path_),
125                 sha1_digest(sha1_digest_)
126         {
127         }
128 };
129
130 struct ServerSoundParams
131 {
132         float gain;
133         std::string to_player;
134         enum Type{
135                 SSP_LOCAL=0,
136                 SSP_POSITIONAL=1,
137                 SSP_OBJECT=2
138         } type;
139         v3f pos;
140         u16 object;
141         float max_hear_distance;
142         bool loop;
143
144         ServerSoundParams():
145                 gain(1.0),
146                 to_player(""),
147                 type(SSP_LOCAL),
148                 pos(0,0,0),
149                 object(0),
150                 max_hear_distance(32*BS),
151                 loop(false)
152         {}
153
154         v3f getPos(ServerEnvironment *env, bool *pos_exists) const;
155 };
156
157 struct ServerPlayingSound
158 {
159         ServerSoundParams params;
160         std::set<u16> clients; // peer ids
161 };
162
163 class Server : public con::PeerHandler, public MapEventReceiver,
164                 public InventoryManager, public IGameDef
165 {
166 public:
167         /*
168                 NOTE: Every public method should be thread-safe
169         */
170
171         Server(
172                 const std::string &path_world,
173                 const SubgameSpec &gamespec,
174                 bool simple_singleplayer_mode,
175                 bool ipv6,
176                 ChatInterface *iface = NULL
177         );
178         ~Server();
179         void start(Address bind_addr);
180         void stop();
181         // This is mainly a way to pass the time to the server.
182         // Actual processing is done in an another thread.
183         void step(float dtime);
184         // This is run by ServerThread and does the actual processing
185         void AsyncRunStep(bool initial_step=false);
186         void Receive();
187         PlayerSAO* StageTwoClientInit(u16 peer_id);
188
189         /*
190          * Command Handlers
191          */
192
193         void handleCommand(NetworkPacket* pkt);
194
195         void handleCommand_Null(NetworkPacket* pkt) {};
196         void handleCommand_Deprecated(NetworkPacket* pkt);
197         void handleCommand_Init(NetworkPacket* pkt);
198         void handleCommand_Init_Legacy(NetworkPacket* pkt);
199         void handleCommand_Init2(NetworkPacket* pkt);
200         void handleCommand_RequestMedia(NetworkPacket* pkt);
201         void handleCommand_ReceivedMedia(NetworkPacket* pkt);
202         void handleCommand_ClientReady(NetworkPacket* pkt);
203         void handleCommand_GotBlocks(NetworkPacket* pkt);
204         void handleCommand_PlayerPos(NetworkPacket* pkt);
205         void handleCommand_DeletedBlocks(NetworkPacket* pkt);
206         void handleCommand_InventoryAction(NetworkPacket* pkt);
207         void handleCommand_ChatMessage(NetworkPacket* pkt);
208         void handleCommand_Damage(NetworkPacket* pkt);
209         void handleCommand_Breath(NetworkPacket* pkt);
210         void handleCommand_Password(NetworkPacket* pkt);
211         void handleCommand_PlayerItem(NetworkPacket* pkt);
212         void handleCommand_Respawn(NetworkPacket* pkt);
213         void handleCommand_Interact(NetworkPacket* pkt);
214         void handleCommand_RemovedSounds(NetworkPacket* pkt);
215         void handleCommand_NodeMetaFields(NetworkPacket* pkt);
216         void handleCommand_InventoryFields(NetworkPacket* pkt);
217         void handleCommand_FirstSrp(NetworkPacket* pkt);
218         void handleCommand_SrpBytesA(NetworkPacket* pkt);
219         void handleCommand_SrpBytesM(NetworkPacket* pkt);
220
221         void ProcessData(NetworkPacket *pkt);
222
223         void Send(NetworkPacket* pkt);
224
225         // Both setter and getter need no envlock,
226         // can be called freely from threads
227         void setTimeOfDay(u32 time);
228
229         /*
230                 Shall be called with the environment locked.
231                 This is accessed by the map, which is inside the environment,
232                 so it shouldn't be a problem.
233         */
234         void onMapEditEvent(MapEditEvent *event);
235
236         /*
237                 Shall be called with the environment and the connection locked.
238         */
239         Inventory* getInventory(const InventoryLocation &loc);
240         void setInventoryModified(const InventoryLocation &loc, bool playerSend = true);
241
242         // Connection must be locked when called
243         std::wstring getStatusString();
244
245         // read shutdown state
246         inline bool getShutdownRequested()
247                         { return m_shutdown_requested; }
248
249         // request server to shutdown
250         inline void requestShutdown() { m_shutdown_requested = true; }
251         void requestShutdown(const std::string &msg, bool reconnect)
252         {
253                 m_shutdown_requested = true;
254                 m_shutdown_msg = msg;
255                 m_shutdown_ask_reconnect = reconnect;
256         }
257
258         // Returns -1 if failed, sound handle on success
259         // Envlock
260         s32 playSound(const SimpleSoundSpec &spec, const ServerSoundParams &params);
261         void stopSound(s32 handle);
262
263         // Envlock
264         std::set<std::string> getPlayerEffectivePrivs(const std::string &name);
265         bool checkPriv(const std::string &name, const std::string &priv);
266         void reportPrivsModified(const std::string &name=""); // ""=all
267         void reportInventoryFormspecModified(const std::string &name);
268
269         void setIpBanned(const std::string &ip, const std::string &name);
270         void unsetIpBanned(const std::string &ip_or_name);
271         std::string getBanDescription(const std::string &ip_or_name);
272
273         void notifyPlayer(const char *name, const std::wstring &msg);
274         void notifyPlayers(const std::wstring &msg);
275         void spawnParticle(const std::string &playername,
276                 v3f pos, v3f velocity, v3f acceleration,
277                 float expirationtime, float size,
278                 bool collisiondetection, bool vertical, const std::string &texture);
279
280         u32 addParticleSpawner(u16 amount, float spawntime,
281                 v3f minpos, v3f maxpos,
282                 v3f minvel, v3f maxvel,
283                 v3f minacc, v3f maxacc,
284                 float minexptime, float maxexptime,
285                 float minsize, float maxsize,
286                 bool collisiondetection, bool vertical, const std::string &texture,
287                 const std::string &playername);
288
289         void deleteParticleSpawner(const std::string &playername, u32 id);
290
291         // Creates or resets inventory
292         Inventory* createDetachedInventory(const std::string &name);
293
294         // Envlock and conlock should be locked when using scriptapi
295         GameScripting *getScriptIface(){ return m_script; }
296
297         // actions: time-reversed list
298         // Return value: success/failure
299         bool rollbackRevertActions(const std::list<RollbackAction> &actions,
300                         std::list<std::string> *log);
301
302         // IGameDef interface
303         // Under envlock
304         virtual IItemDefManager* getItemDefManager();
305         virtual INodeDefManager* getNodeDefManager();
306         virtual ICraftDefManager* getCraftDefManager();
307         virtual ITextureSource* getTextureSource();
308         virtual IShaderSource* getShaderSource();
309         virtual u16 allocateUnknownNodeId(const std::string &name);
310         virtual ISoundManager* getSoundManager();
311         virtual MtEventManager* getEventManager();
312         virtual scene::ISceneManager* getSceneManager();
313         virtual IRollbackManager *getRollbackManager() { return m_rollback; }
314         virtual EmergeManager *getEmergeManager() { return m_emerge; }
315
316         IWritableItemDefManager* getWritableItemDefManager();
317         IWritableNodeDefManager* getWritableNodeDefManager();
318         IWritableCraftDefManager* getWritableCraftDefManager();
319
320         const ModSpec* getModSpec(const std::string &modname) const;
321         void getModNames(std::vector<std::string> &modlist);
322         std::string getBuiltinLuaPath();
323         inline std::string getWorldPath() const
324                         { return m_path_world; }
325
326         inline bool isSingleplayer()
327                         { return m_simple_singleplayer_mode; }
328
329         inline void setAsyncFatalError(const std::string &error)
330                         { m_async_fatal_error.set(error); }
331
332         bool showFormspec(const char *name, const std::string &formspec, const std::string &formname);
333         Map & getMap() { return m_env->getMap(); }
334         ServerEnvironment & getEnv() { return *m_env; }
335
336         u32 hudAdd(Player *player, HudElement *element);
337         bool hudRemove(Player *player, u32 id);
338         bool hudChange(Player *player, u32 id, HudElementStat stat, void *value);
339         bool hudSetFlags(Player *player, u32 flags, u32 mask);
340         bool hudSetHotbarItemcount(Player *player, s32 hotbar_itemcount);
341         s32 hudGetHotbarItemcount(Player *player);
342         void hudSetHotbarImage(Player *player, std::string name);
343         std::string hudGetHotbarImage(Player *player);
344         void hudSetHotbarSelectedImage(Player *player, std::string name);
345         std::string hudGetHotbarSelectedImage(Player *player);
346
347         inline Address getPeerAddress(u16 peer_id)
348                         { return m_con.GetPeerAddress(peer_id); }
349
350         bool setLocalPlayerAnimations(Player *player, v2s32 animation_frames[4], f32 frame_speed);
351         bool setPlayerEyeOffset(Player *player, v3f first, v3f third);
352
353         bool setSky(Player *player, const video::SColor &bgcolor,
354                         const std::string &type, const std::vector<std::string> &params);
355
356         bool overrideDayNightRatio(Player *player, bool do_override,
357                         float brightness);
358
359         /* con::PeerHandler implementation. */
360         void peerAdded(con::Peer *peer);
361         void deletingPeer(con::Peer *peer, bool timeout);
362
363         void DenySudoAccess(u16 peer_id);
364         void DenyAccessVerCompliant(u16 peer_id, u16 proto_ver, AccessDeniedCode reason,
365                 const std::string &str_reason = "", bool reconnect = false);
366         void DenyAccess(u16 peer_id, AccessDeniedCode reason, const std::string &custom_reason="");
367         void acceptAuth(u16 peer_id, bool forSudoMode);
368         void DenyAccess_Legacy(u16 peer_id, const std::wstring &reason);
369         bool getClientConInfo(u16 peer_id, con::rtt_stat_type type,float* retval);
370         bool getClientInfo(u16 peer_id,ClientState* state, u32* uptime,
371                         u8* ser_vers, u16* prot_vers, u8* major, u8* minor, u8* patch,
372                         std::string* vers_string);
373
374         void printToConsoleOnly(const std::string &text);
375
376         void SendPlayerHPOrDie(PlayerSAO *player);
377         void SendPlayerBreath(u16 peer_id);
378         void SendInventory(PlayerSAO* playerSAO);
379         void SendMovePlayer(u16 peer_id);
380
381         // Bind address
382         Address m_bind_addr;
383
384         // Environment mutex (envlock)
385         Mutex m_env_mutex;
386
387 private:
388
389         friend class EmergeThread;
390         friend class RemoteClient;
391
392         void SendMovement(u16 peer_id);
393         void SendHP(u16 peer_id, u8 hp);
394         void SendBreath(u16 peer_id, u16 breath);
395         void SendAccessDenied(u16 peer_id, AccessDeniedCode reason,
396                 const std::string &custom_reason, bool reconnect = false);
397         void SendAccessDenied_Legacy(u16 peer_id, const std::wstring &reason);
398         void SendDeathscreen(u16 peer_id,bool set_camera_point_target, v3f camera_point_target);
399         void SendItemDef(u16 peer_id,IItemDefManager *itemdef, u16 protocol_version);
400         void SendNodeDef(u16 peer_id,INodeDefManager *nodedef, u16 protocol_version);
401
402         /* mark blocks not sent for all clients */
403         void SetBlocksNotSent(std::map<v3s16, MapBlock *>& block);
404
405
406         void SendChatMessage(u16 peer_id, const std::wstring &message);
407         void SendTimeOfDay(u16 peer_id, u16 time, f32 time_speed);
408         void SendPlayerHP(u16 peer_id);
409
410         void SendLocalPlayerAnimations(u16 peer_id, v2s32 animation_frames[4], f32 animation_speed);
411         void SendEyeOffset(u16 peer_id, v3f first, v3f third);
412         void SendPlayerPrivileges(u16 peer_id);
413         void SendPlayerInventoryFormspec(u16 peer_id);
414         void SendShowFormspecMessage(u16 peer_id, const std::string &formspec, const std::string &formname);
415         void SendHUDAdd(u16 peer_id, u32 id, HudElement *form);
416         void SendHUDRemove(u16 peer_id, u32 id);
417         void SendHUDChange(u16 peer_id, u32 id, HudElementStat stat, void *value);
418         void SendHUDSetFlags(u16 peer_id, u32 flags, u32 mask);
419         void SendHUDSetParam(u16 peer_id, u16 param, const std::string &value);
420         void SendSetSky(u16 peer_id, const video::SColor &bgcolor,
421                         const std::string &type, const std::vector<std::string> &params);
422         void SendOverrideDayNightRatio(u16 peer_id, bool do_override, float ratio);
423
424         /*
425                 Send a node removal/addition event to all clients except ignore_id.
426                 Additionally, if far_players!=NULL, players further away than
427                 far_d_nodes are ignored and their peer_ids are added to far_players
428         */
429         // Envlock and conlock should be locked when calling these
430         void sendRemoveNode(v3s16 p, u16 ignore_id=0,
431                         std::vector<u16> *far_players=NULL, float far_d_nodes=100);
432         void sendAddNode(v3s16 p, MapNode n, u16 ignore_id=0,
433                         std::vector<u16> *far_players=NULL, float far_d_nodes=100,
434                         bool remove_metadata=true);
435         void setBlockNotSent(v3s16 p);
436
437         // Environment and Connection must be locked when called
438         void SendBlockNoLock(u16 peer_id, MapBlock *block, u8 ver, u16 net_proto_version);
439
440         // Sends blocks to clients (locks env and con on its own)
441         void SendBlocks(float dtime);
442
443         void fillMediaCache();
444         void sendMediaAnnouncement(u16 peer_id);
445         void sendRequestedMedia(u16 peer_id,
446                         const std::vector<std::string> &tosend);
447
448         void sendDetachedInventory(const std::string &name, u16 peer_id);
449         void sendDetachedInventories(u16 peer_id);
450
451         // Adds a ParticleSpawner on peer with peer_id (PEER_ID_INEXISTENT == all)
452         void SendAddParticleSpawner(u16 peer_id, u16 amount, float spawntime,
453                 v3f minpos, v3f maxpos,
454                 v3f minvel, v3f maxvel,
455                 v3f minacc, v3f maxacc,
456                 float minexptime, float maxexptime,
457                 float minsize, float maxsize,
458                 bool collisiondetection, bool vertical, std::string texture, u32 id);
459
460         void SendDeleteParticleSpawner(u16 peer_id, u32 id);
461
462         // Spawns particle on peer with peer_id (PEER_ID_INEXISTENT == all)
463         void SendSpawnParticle(u16 peer_id,
464                 v3f pos, v3f velocity, v3f acceleration,
465                 float expirationtime, float size,
466                 bool collisiondetection, bool vertical, std::string texture);
467
468         u32 SendActiveObjectRemoveAdd(u16 peer_id, const std::string &datas);
469         void SendActiveObjectMessages(u16 peer_id, const std::string &datas, bool reliable = true);
470         /*
471                 Something random
472         */
473
474         void DiePlayer(u16 peer_id);
475         void RespawnPlayer(u16 peer_id);
476         void DeleteClient(u16 peer_id, ClientDeletionReason reason);
477         void UpdateCrafting(Player *player);
478
479         // This returns the answer to the sender of wmessage, or "" if there is none
480         std::wstring handleChat(const std::string &name, const std::wstring &wname,
481                 const std::wstring &wmessage,
482                 u16 peer_id_to_avoid_sending = PEER_ID_INEXISTENT);
483         void handleAdminChat(const ChatEventChat *evt);
484
485         v3f findSpawnPos();
486
487         // When called, connection mutex should be locked
488         RemoteClient* getClient(u16 peer_id,ClientState state_min=CS_Active);
489         RemoteClient* getClientNoEx(u16 peer_id,ClientState state_min=CS_Active);
490
491         // When called, environment mutex should be locked
492         std::string getPlayerName(u16 peer_id);
493         PlayerSAO* getPlayerSAO(u16 peer_id);
494
495         /*
496                 Get a player from memory or creates one.
497                 If player is already connected, return NULL
498                 Does not verify/modify auth info and password.
499
500                 Call with env and con locked.
501         */
502         PlayerSAO *emergePlayer(const char *name, u16 peer_id, u16 proto_version);
503
504         void handlePeerChanges();
505
506         /*
507                 Variables
508         */
509
510         // World directory
511         std::string m_path_world;
512         // Subgame specification
513         SubgameSpec m_gamespec;
514         // If true, do not allow multiple players and hide some multiplayer
515         // functionality
516         bool m_simple_singleplayer_mode;
517
518         // Thread can set; step() will throw as ServerError
519         MutexedVariable<std::string> m_async_fatal_error;
520
521         // Some timers
522         float m_liquid_transform_timer;
523         float m_liquid_transform_every;
524         float m_print_info_timer;
525         float m_masterserver_timer;
526         float m_objectdata_timer;
527         float m_emergethread_trigger_timer;
528         float m_savemap_timer;
529         IntervalLimiter m_map_timer_and_unload_interval;
530
531         // Environment
532         ServerEnvironment *m_env;
533
534         // server connection
535         con::Connection m_con;
536
537         // Ban checking
538         BanManager *m_banmanager;
539
540         // Rollback manager (behind m_env_mutex)
541         IRollbackManager *m_rollback;
542         bool m_enable_rollback_recording; // Updated once in a while
543
544         // Emerge manager
545         EmergeManager *m_emerge;
546
547         // Scripting
548         // Envlock and conlock should be locked when using Lua
549         GameScripting *m_script;
550
551         // Item definition manager
552         IWritableItemDefManager *m_itemdef;
553
554         // Node definition manager
555         IWritableNodeDefManager *m_nodedef;
556
557         // Craft definition manager
558         IWritableCraftDefManager *m_craftdef;
559
560         // Event manager
561         EventManager *m_event;
562
563         // Mods
564         std::vector<ModSpec> m_mods;
565
566         /*
567                 Threads
568         */
569
570         // A buffer for time steps
571         // step() increments and AsyncRunStep() run by m_thread reads it.
572         float m_step_dtime;
573         Mutex m_step_dtime_mutex;
574
575         // current server step lag counter
576         float m_lag;
577
578         // The server mainly operates in this thread
579         ServerThread *m_thread;
580
581         /*
582                 Time related stuff
583         */
584
585         // Timer for sending time of day over network
586         float m_time_of_day_send_timer;
587         // Uptime of server in seconds
588         MutexedVariable<double> m_uptime;
589
590         /*
591          Client interface
592          */
593         ClientInterface m_clients;
594
595         /*
596                 Peer change queue.
597                 Queues stuff from peerAdded() and deletingPeer() to
598                 handlePeerChanges()
599         */
600         std::queue<con::PeerChange> m_peer_change_queue;
601
602         /*
603                 Random stuff
604         */
605
606         bool m_shutdown_requested;
607         std::string m_shutdown_msg;
608         bool m_shutdown_ask_reconnect;
609
610         ChatInterface *m_admin_chat;
611         std::string m_admin_nick;
612
613         /*
614                 Map edit event queue. Automatically receives all map edits.
615                 The constructor of this class registers us to receive them through
616                 onMapEditEvent
617
618                 NOTE: Should these be moved to actually be members of
619                 ServerEnvironment?
620         */
621
622         /*
623                 Queue of map edits from the environment for sending to the clients
624                 This is behind m_env_mutex
625         */
626         std::queue<MapEditEvent*> m_unsent_map_edit_queue;
627         /*
628                 Set to true when the server itself is modifying the map and does
629                 all sending of information by itself.
630                 This is behind m_env_mutex
631         */
632         bool m_ignore_map_edit_events;
633         /*
634                 If a non-empty area, map edit events contained within are left
635                 unsent. Done at map generation time to speed up editing of the
636                 generated area, as it will be sent anyway.
637                 This is behind m_env_mutex
638         */
639         VoxelArea m_ignore_map_edit_events_area;
640         /*
641                 If set to !=0, the incoming MapEditEvents are modified to have
642                 this peed id as the disabled recipient
643                 This is behind m_env_mutex
644         */
645         u16 m_ignore_map_edit_events_peer_id;
646
647         // media files known to server
648         std::map<std::string,MediaInfo> m_media;
649
650         /*
651                 Sounds
652         */
653         std::map<s32, ServerPlayingSound> m_playing_sounds;
654         s32 m_next_sound_id;
655
656         /*
657                 Detached inventories (behind m_env_mutex)
658         */
659         // key = name
660         std::map<std::string, Inventory*> m_detached_inventories;
661
662         /*
663                 Particles
664         */
665         std::vector<u32> m_particlespawner_ids;
666
667         DISABLE_CLASS_COPY(Server);
668 };
669
670 /*
671         Runs a simple dedicated server loop.
672
673         Shuts down when kill is set to true.
674 */
675 void dedicated_server_loop(Server &server, bool &kill);
676
677 #endif
678