mirror of
https://github.com/minetest/minetest.git
synced 2024-12-16 11:19:22 +01:00
465 lines
15 KiB
C++
465 lines
15 KiB
C++
/*
|
|
Minetest
|
|
Copyright (C) 2010-2014 celeron55, Perttu Ahola <celeron55@gmail.com>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License along
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
#ifndef _CLIENTIFACE_H_
|
|
#define _CLIENTIFACE_H_
|
|
|
|
#include "irr_v3d.h" // for irrlicht datatypes
|
|
|
|
#include "constants.h"
|
|
#include "serialization.h" // for SER_FMT_VER_INVALID
|
|
#include "jthread/jmutex.h"
|
|
|
|
#include <list>
|
|
#include <vector>
|
|
#include <map>
|
|
#include <set>
|
|
|
|
class MapBlock;
|
|
class ServerEnvironment;
|
|
class EmergeManager;
|
|
|
|
/*
|
|
* State Transitions
|
|
|
|
Start
|
|
(peer connect)
|
|
|
|
|
v
|
|
/-----------------\
|
|
| |
|
|
| Created |
|
|
| |
|
|
\-----------------/
|
|
|
|
|
|
|
|
+-----------------------------+ invalid playername, password
|
|
|IN: | or denied by mod
|
|
| TOSERVER_INIT |------------------------------
|
|
+-----------------------------+ |
|
|
| |
|
|
| Auth ok |
|
|
| |
|
|
+-----------------------------+ |
|
|
|OUT: | |
|
|
| TOCLIENT_INIT | |
|
|
+-----------------------------+ |
|
|
| |
|
|
v |
|
|
/-----------------\ |
|
|
| | |
|
|
| InitSent | |
|
|
| | |
|
|
\-----------------/ +------------------
|
|
| | |
|
|
+-----------------------------+ +-----------------------------+ |
|
|
|IN: | |OUT: | |
|
|
| TOSERVER_INIT2 | | TOCLIENT_ACCESS_DENIED | |
|
|
+-----------------------------+ +-----------------------------+ |
|
|
| | |
|
|
v v |
|
|
/-----------------\ /-----------------\ |
|
|
| | | | |
|
|
| InitDone | | Denied | |
|
|
| | | | |
|
|
\-----------------/ \-----------------/ |
|
|
| |
|
|
+-----------------------------+ |
|
|
|OUT: | |
|
|
| TOCLIENT_MOVEMENT | |
|
|
| TOCLIENT_ITEMDEF | |
|
|
| TOCLIENT_NODEDEF | |
|
|
| TOCLIENT_ANNOUNCE_MEDIA | |
|
|
| TOCLIENT_DETACHED_INVENTORY | |
|
|
| TOCLIENT_TIME_OF_DAY | |
|
|
+-----------------------------+ |
|
|
| |
|
|
| |
|
|
| ----------------------------------- |
|
|
v | | |
|
|
/-----------------\ v |
|
|
| | +-----------------------------+ |
|
|
| DefinitionsSent | |IN: | |
|
|
| | | TOSERVER_REQUEST_MEDIA | |
|
|
\-----------------/ | TOSERVER_RECEIVED_MEDIA | |
|
|
| +-----------------------------+ |
|
|
| ^ | |
|
|
| ----------------------------------- |
|
|
| |
|
|
+-----------------------------+ |
|
|
|IN: | |
|
|
| TOSERVER_CLIENT_READY | |
|
|
+-----------------------------+ |
|
|
| async |
|
|
v mod action |
|
|
+-----------------------------+ (ban,kick) |
|
|
|OUT: | |
|
|
| TOCLIENT_MOVE_PLAYER | |
|
|
| TOCLIENT_PRIVILEGES | |
|
|
| TOCLIENT_INVENTORY_FORMSPEC | |
|
|
| UpdateCrafting | |
|
|
| TOCLIENT_INVENTORY | |
|
|
| TOCLIENT_HP (opt) | |
|
|
| TOCLIENT_BREATH | |
|
|
| TOCLIENT_DEATHSCREEN | |
|
|
+-----------------------------+ |
|
|
| |
|
|
v |
|
|
/-----------------\ |
|
|
| |------------------------------------------------------
|
|
| Active |
|
|
| |----------------------------------
|
|
\-----------------/ timeout |
|
|
| +-----------------------------+
|
|
| |OUT: |
|
|
| | TOCLIENT_DISCONNECT |
|
|
| +-----------------------------+
|
|
| |
|
|
| v
|
|
+-----------------------------+ /-----------------\
|
|
|IN: | | |
|
|
| TOSERVER_DISCONNECT |------------------->| Disconnecting |
|
|
+-----------------------------+ | |
|
|
\-----------------/
|
|
*/
|
|
namespace con {
|
|
class Connection;
|
|
}
|
|
|
|
#define CI_ARRAYSIZE(a) (sizeof(a) / sizeof((a)[0]))
|
|
|
|
enum ClientState
|
|
{
|
|
CS_Invalid,
|
|
CS_Disconnecting,
|
|
CS_Denied,
|
|
CS_Created,
|
|
CS_InitSent,
|
|
CS_InitDone,
|
|
CS_DefinitionsSent,
|
|
CS_Active
|
|
};
|
|
|
|
enum ClientStateEvent
|
|
{
|
|
CSE_Init,
|
|
CSE_GotInit2,
|
|
CSE_SetDenied,
|
|
CSE_SetDefinitionsSent,
|
|
CSE_SetClientReady,
|
|
CSE_Disconnect
|
|
};
|
|
|
|
/*
|
|
Used for queueing and sorting block transfers in containers
|
|
|
|
Lower priority number means higher priority.
|
|
*/
|
|
struct PrioritySortedBlockTransfer
|
|
{
|
|
PrioritySortedBlockTransfer(float a_priority, v3s16 a_pos, u16 a_peer_id)
|
|
{
|
|
priority = a_priority;
|
|
pos = a_pos;
|
|
peer_id = a_peer_id;
|
|
}
|
|
bool operator < (const PrioritySortedBlockTransfer &other) const
|
|
{
|
|
return priority < other.priority;
|
|
}
|
|
float priority;
|
|
v3s16 pos;
|
|
u16 peer_id;
|
|
};
|
|
|
|
class RemoteClient
|
|
{
|
|
public:
|
|
// peer_id=0 means this client has no associated peer
|
|
// NOTE: If client is made allowed to exist while peer doesn't,
|
|
// this has to be set to 0 when there is no peer.
|
|
// Also, the client must be moved to some other container.
|
|
u16 peer_id;
|
|
// The serialization version to use with the client
|
|
u8 serialization_version;
|
|
//
|
|
u16 net_proto_version;
|
|
|
|
RemoteClient():
|
|
peer_id(PEER_ID_INEXISTENT),
|
|
serialization_version(SER_FMT_VER_INVALID),
|
|
net_proto_version(0),
|
|
m_time_from_building(9999),
|
|
m_pending_serialization_version(SER_FMT_VER_INVALID),
|
|
m_state(CS_Created),
|
|
m_nearest_unsent_d(0),
|
|
m_nearest_unsent_reset_timer(0.0),
|
|
m_excess_gotblocks(0),
|
|
m_nothing_to_send_pause_timer(0.0),
|
|
m_name(""),
|
|
m_version_major(0),
|
|
m_version_minor(0),
|
|
m_version_patch(0),
|
|
m_full_version("unknown"),
|
|
m_connection_time(getTime(PRECISION_SECONDS))
|
|
{
|
|
}
|
|
~RemoteClient()
|
|
{
|
|
}
|
|
|
|
/*
|
|
Finds block that should be sent next to the client.
|
|
Environment should be locked when this is called.
|
|
dtime is used for resetting send radius at slow interval
|
|
*/
|
|
void GetNextBlocks(ServerEnvironment *env, EmergeManager* emerge,
|
|
float dtime, std::vector<PrioritySortedBlockTransfer> &dest);
|
|
|
|
void GotBlock(v3s16 p);
|
|
|
|
void SentBlock(v3s16 p);
|
|
|
|
void SetBlockNotSent(v3s16 p);
|
|
void SetBlocksNotSent(std::map<v3s16, MapBlock*> &blocks);
|
|
|
|
/**
|
|
* tell client about this block being modified right now.
|
|
* this information is required to requeue the block in case it's "on wire"
|
|
* while modification is processed by server
|
|
* @param p position of modified block
|
|
*/
|
|
void ResendBlockIfOnWire(v3s16 p);
|
|
|
|
s32 SendingCount()
|
|
{
|
|
return m_blocks_sending.size();
|
|
}
|
|
|
|
// Increments timeouts and removes timed-out blocks from list
|
|
// NOTE: This doesn't fix the server-not-sending-block bug
|
|
// because it is related to emerging, not sending.
|
|
//void RunSendingTimeouts(float dtime, float timeout);
|
|
|
|
void PrintInfo(std::ostream &o)
|
|
{
|
|
o<<"RemoteClient "<<peer_id<<": "
|
|
<<"m_blocks_sent.size()="<<m_blocks_sent.size()
|
|
<<", m_blocks_sending.size()="<<m_blocks_sending.size()
|
|
<<", m_nearest_unsent_d="<<m_nearest_unsent_d
|
|
<<", m_excess_gotblocks="<<m_excess_gotblocks
|
|
<<std::endl;
|
|
m_excess_gotblocks = 0;
|
|
}
|
|
|
|
// Time from last placing or removing blocks
|
|
float m_time_from_building;
|
|
|
|
/*
|
|
List of active objects that the client knows of.
|
|
Value is dummy.
|
|
*/
|
|
std::set<u16> m_known_objects;
|
|
|
|
ClientState getState()
|
|
{ return m_state; }
|
|
|
|
std::string getName()
|
|
{ return m_name; }
|
|
|
|
void setName(std::string name)
|
|
{ m_name = name; }
|
|
|
|
/* update internal client state */
|
|
void notifyEvent(ClientStateEvent event);
|
|
|
|
/* set expected serialization version */
|
|
void setPendingSerializationVersion(u8 version)
|
|
{ m_pending_serialization_version = version; }
|
|
|
|
void confirmSerializationVersion()
|
|
{ serialization_version = m_pending_serialization_version; }
|
|
|
|
/* get uptime */
|
|
u32 uptime();
|
|
|
|
|
|
/* set version information */
|
|
void setVersionInfo(u8 major, u8 minor, u8 patch, std::string full) {
|
|
m_version_major = major;
|
|
m_version_minor = minor;
|
|
m_version_patch = patch;
|
|
m_full_version = full;
|
|
}
|
|
|
|
/* read version information */
|
|
u8 getMajor() { return m_version_major; }
|
|
u8 getMinor() { return m_version_minor; }
|
|
u8 getPatch() { return m_version_patch; }
|
|
std::string getVersion() { return m_full_version; }
|
|
private:
|
|
// Version is stored in here after INIT before INIT2
|
|
u8 m_pending_serialization_version;
|
|
|
|
/* current state of client */
|
|
ClientState m_state;
|
|
|
|
/*
|
|
Blocks that have been sent to client.
|
|
- These don't have to be sent again.
|
|
- A block is cleared from here when client says it has
|
|
deleted it from it's memory
|
|
|
|
Key is position, value is dummy.
|
|
No MapBlock* is stored here because the blocks can get deleted.
|
|
*/
|
|
std::set<v3s16> m_blocks_sent;
|
|
s16 m_nearest_unsent_d;
|
|
v3s16 m_last_center;
|
|
float m_nearest_unsent_reset_timer;
|
|
|
|
/*
|
|
Blocks that are currently on the line.
|
|
This is used for throttling the sending of blocks.
|
|
- The size of this list is limited to some value
|
|
Block is added when it is sent with BLOCKDATA.
|
|
Block is removed when GOTBLOCKS is received.
|
|
Value is time from sending. (not used at the moment)
|
|
*/
|
|
std::map<v3s16, float> m_blocks_sending;
|
|
|
|
/*
|
|
Count of excess GotBlocks().
|
|
There is an excess amount because the client sometimes
|
|
gets a block so late that the server sends it again,
|
|
and the client then sends two GOTBLOCKs.
|
|
This is resetted by PrintInfo()
|
|
*/
|
|
u32 m_excess_gotblocks;
|
|
|
|
// CPU usage optimization
|
|
float m_nothing_to_send_pause_timer;
|
|
|
|
/*
|
|
name of player using this client
|
|
*/
|
|
std::string m_name;
|
|
|
|
/*
|
|
client information
|
|
*/
|
|
u8 m_version_major;
|
|
u8 m_version_minor;
|
|
u8 m_version_patch;
|
|
|
|
std::string m_full_version;
|
|
|
|
/*
|
|
time this client was created
|
|
*/
|
|
const u32 m_connection_time;
|
|
};
|
|
|
|
class ClientInterface {
|
|
public:
|
|
|
|
friend class Server;
|
|
|
|
ClientInterface(con::Connection* con);
|
|
~ClientInterface();
|
|
|
|
/* run sync step */
|
|
void step(float dtime);
|
|
|
|
/* get list of active client id's */
|
|
std::list<u16> getClientIDs(ClientState min_state=CS_Active);
|
|
|
|
/* get list of client player names */
|
|
std::vector<std::string> getPlayerNames();
|
|
|
|
/* send message to client */
|
|
void send(u16 peer_id, u8 channelnum, SharedBuffer<u8> data, bool reliable);
|
|
|
|
/* send to all clients */
|
|
void sendToAll(u16 channelnum, SharedBuffer<u8> data, bool reliable);
|
|
|
|
/* delete a client */
|
|
void DeleteClient(u16 peer_id);
|
|
|
|
/* create client */
|
|
void CreateClient(u16 peer_id);
|
|
|
|
/* get a client by peer_id */
|
|
RemoteClient* getClientNoEx(u16 peer_id, ClientState state_min=CS_Active);
|
|
|
|
/* get client by peer_id (make sure you have list lock before!*/
|
|
RemoteClient* lockedGetClientNoEx(u16 peer_id, ClientState state_min=CS_Active);
|
|
|
|
/* get state of client by id*/
|
|
ClientState getClientState(u16 peer_id);
|
|
|
|
/* set client playername */
|
|
void setPlayerName(u16 peer_id,std::string name);
|
|
|
|
/* get protocol version of client */
|
|
u16 getProtocolVersion(u16 peer_id);
|
|
|
|
/* set client version */
|
|
void setClientVersion(u16 peer_id, u8 major, u8 minor, u8 patch, std::string full);
|
|
|
|
/* event to update client state */
|
|
void event(u16 peer_id, ClientStateEvent event);
|
|
|
|
/* set environment */
|
|
void setEnv(ServerEnvironment* env)
|
|
{ assert(m_env == 0); m_env = env; }
|
|
|
|
static std::string state2Name(ClientState state);
|
|
|
|
protected:
|
|
//TODO find way to avoid this functions
|
|
void Lock()
|
|
{ m_clients_mutex.Lock(); }
|
|
void Unlock()
|
|
{ m_clients_mutex.Unlock(); }
|
|
|
|
std::map<u16, RemoteClient*>& getClientList()
|
|
{ return m_clients; }
|
|
|
|
private:
|
|
/* update internal player list */
|
|
void UpdatePlayerList();
|
|
|
|
// Connection
|
|
con::Connection* m_con;
|
|
JMutex m_clients_mutex;
|
|
// Connected clients (behind the con mutex)
|
|
std::map<u16, RemoteClient*> m_clients;
|
|
std::vector<std::string> m_clients_names; //for announcing masterserver
|
|
|
|
// Environment
|
|
ServerEnvironment *m_env;
|
|
JMutex m_env_mutex;
|
|
|
|
float m_print_info_timer;
|
|
|
|
static const char *statenames[];
|
|
};
|
|
|
|
#endif
|