3 Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
4 Copyright (C) 2010-2013 kwolekr, Ryan Kwolek <kwolekr@minetest.net>
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License along
17 with this program; if not, write to the Free Software Foundation, Inc.,
18 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
27 #include "util/container.h"
28 #include "util/thread.h"
29 #include "threading/event.h"
32 #include "constants.h"
33 #include "environment.h"
37 #include "mapgen_flat.h"
38 #include "mapgen_fractal.h"
39 #include "mapgen_v5.h"
40 #include "mapgen_v6.h"
41 #include "mapgen_v7.h"
42 #include "mapgen_valleys.h"
43 #include "mapgen_singlenode.h"
46 #include "mg_decoration.h"
47 #include "mg_schematic.h"
50 #include "scripting_game.h"
52 #include "serverobject.h"
59 MapgenFactory *factory;
63 class EmergeThread : public Thread {
65 bool enable_mapgen_debug_info;
68 EmergeThread(Server *server, int ethreadid);
74 // Requires queue mutex held
75 bool pushBlock(v3s16 pos);
77 void cancelPendingItems();
79 static void runCompletionCallbacks(
80 v3s16 pos, EmergeAction action,
81 const EmergeCallbackList &callbacks);
86 EmergeManager *m_emerge;
90 std::queue<v3s16> m_block_queue;
92 bool popBlockEmerge(v3s16 *pos, BlockEmergeData *bedata);
94 EmergeAction getBlockOrStartGen(
95 v3s16 pos, bool allow_gen, MapBlock **block, BlockMakeData *data);
96 MapBlock *finishGen(v3s16 pos, BlockMakeData *bmdata,
97 std::map<v3s16, MapBlock *> *modified_blocks);
99 friend class EmergeManager;
103 //// Built-in mapgens
106 MapgenDesc g_reg_mapgens[] = {
107 {"v5", new MapgenFactoryV5, true},
108 {"v6", new MapgenFactoryV6, true},
109 {"v7", new MapgenFactoryV7, true},
110 {"flat", new MapgenFactoryFlat, true},
111 {"fractal", new MapgenFactoryFractal, true},
112 {"valleys", new MapgenFactoryValleys, true},
113 {"singlenode", new MapgenFactorySinglenode, false},
120 EmergeManager::EmergeManager(IGameDef *gamedef)
122 this->ndef = gamedef->getNodeDefManager();
123 this->biomemgr = new BiomeManager(gamedef);
124 this->oremgr = new OreManager(gamedef);
125 this->decomgr = new DecorationManager(gamedef);
126 this->schemmgr = new SchematicManager(gamedef);
127 this->gen_notify_on = 0;
129 // Note that accesses to this variable are not synchronized.
130 // This is because the *only* thread ever starting or stopping
131 // EmergeThreads should be the ServerThread.
132 this->m_threads_active = false;
134 enable_mapgen_debug_info = g_settings->getBool("enable_mapgen_debug_info");
136 // If unspecified, leave a proc for the main thread and one for
137 // some other misc thread
139 if (!g_settings->getS16NoEx("num_emerge_threads", nthreads))
140 nthreads = Thread::getNumberOfProcessors() - 2;
144 m_qlimit_total = g_settings->getU16("emergequeue_limit_total");
145 if (!g_settings->getU16NoEx("emergequeue_limit_diskonly", m_qlimit_diskonly))
146 m_qlimit_diskonly = nthreads * 5 + 1;
147 if (!g_settings->getU16NoEx("emergequeue_limit_generate", m_qlimit_generate))
148 m_qlimit_generate = nthreads + 1;
150 // don't trust user input for something very important like this
151 if (m_qlimit_total < 1)
153 if (m_qlimit_diskonly < 1)
154 m_qlimit_diskonly = 1;
155 if (m_qlimit_generate < 1)
156 m_qlimit_generate = 1;
158 for (s16 i = 0; i < nthreads; i++)
159 m_threads.push_back(new EmergeThread((Server *)gamedef, i));
161 infostream << "EmergeManager: using " << nthreads << " threads" << std::endl;
165 EmergeManager::~EmergeManager()
167 for (u32 i = 0; i != m_threads.size(); i++) {
168 EmergeThread *thread = m_threads[i];
170 if (m_threads_active) {
185 delete params.sparams;
189 void EmergeManager::loadMapgenParams()
191 params.load(*g_settings);
195 void EmergeManager::initMapgens()
197 if (m_mapgens.size())
200 MapgenFactory *mgfactory = getMapgenFactory(params.mg_name);
202 errorstream << "EmergeManager: mapgen " << params.mg_name <<
203 " not registered; falling back to " << DEFAULT_MAPGEN << std::endl;
205 params.mg_name = DEFAULT_MAPGEN;
207 mgfactory = getMapgenFactory(params.mg_name);
208 FATAL_ERROR_IF(mgfactory == NULL, "Couldn't use any mapgen!");
211 if (!params.sparams) {
212 params.sparams = mgfactory->createMapgenParams();
213 params.sparams->readParams(g_settings);
216 for (u32 i = 0; i != m_threads.size(); i++) {
217 Mapgen *mg = mgfactory->createMapgen(i, ¶ms, this);
218 m_mapgens.push_back(mg);
223 Mapgen *EmergeManager::getCurrentMapgen()
225 for (u32 i = 0; i != m_threads.size(); i++) {
226 if (m_threads[i]->isCurrentThread())
227 return m_threads[i]->m_mapgen;
234 void EmergeManager::startThreads()
236 if (m_threads_active)
239 for (u32 i = 0; i != m_threads.size(); i++)
240 m_threads[i]->start();
242 m_threads_active = true;
246 void EmergeManager::stopThreads()
248 if (!m_threads_active)
251 // Request thread stop in parallel
252 for (u32 i = 0; i != m_threads.size(); i++) {
253 m_threads[i]->stop();
254 m_threads[i]->signal();
257 // Then do the waiting for each
258 for (u32 i = 0; i != m_threads.size(); i++)
259 m_threads[i]->wait();
261 m_threads_active = false;
265 bool EmergeManager::isRunning()
267 return m_threads_active;
271 bool EmergeManager::enqueueBlockEmerge(
275 bool ignore_queue_limits)
279 flags |= BLOCK_EMERGE_ALLOW_GEN;
280 if (ignore_queue_limits)
281 flags |= BLOCK_EMERGE_FORCE_QUEUE;
283 return enqueueBlockEmergeEx(blockpos, peer_id, flags, NULL, NULL);
287 bool EmergeManager::enqueueBlockEmergeEx(
291 EmergeCompletionCallback callback,
292 void *callback_param)
294 EmergeThread *thread = NULL;
295 bool entry_already_exists = false;
298 MutexAutoLock queuelock(m_queue_mutex);
300 if (!pushBlockEmergeData(blockpos, peer_id, flags,
301 callback, callback_param, &entry_already_exists))
304 if (entry_already_exists)
307 thread = getOptimalThread();
308 thread->pushBlock(blockpos);
318 // Mapgen-related helper functions
321 v3s16 EmergeManager::getContainingChunk(v3s16 blockpos)
323 return getContainingChunk(blockpos, params.chunksize);
327 v3s16 EmergeManager::getContainingChunk(v3s16 blockpos, s16 chunksize)
329 s16 coff = -chunksize / 2;
330 v3s16 chunk_offset(coff, coff, coff);
332 return getContainerPos(blockpos - chunk_offset, chunksize)
333 * chunksize + chunk_offset;
337 int EmergeManager::getSpawnLevelAtPoint(v2s16 p)
339 if (m_mapgens.size() == 0 || !m_mapgens[0]) {
340 errorstream << "EmergeManager: getSpawnLevelAtPoint() called"
341 " before mapgen init" << std::endl;
345 return m_mapgens[0]->getSpawnLevelAtPoint(p);
349 int EmergeManager::getGroundLevelAtPoint(v2s16 p)
351 if (m_mapgens.size() == 0 || !m_mapgens[0]) {
352 errorstream << "EmergeManager: getGroundLevelAtPoint() called"
353 " before mapgen init" << std::endl;
357 return m_mapgens[0]->getGroundLevelAtPoint(p);
361 bool EmergeManager::isBlockUnderground(v3s16 blockpos)
364 v2s16 p = v2s16((blockpos.X * MAP_BLOCKSIZE) + MAP_BLOCKSIZE / 2,
365 (blockpos.Y * MAP_BLOCKSIZE) + MAP_BLOCKSIZE / 2);
366 int ground_level = getGroundLevelAtPoint(p);
367 return blockpos.Y * (MAP_BLOCKSIZE + 1) <= min(water_level, ground_level);
370 // Use a simple heuristic; the above method is wildly inaccurate anyway.
371 return blockpos.Y * (MAP_BLOCKSIZE + 1) <= params.water_level;
375 void EmergeManager::getMapgenNames(
376 std::vector<const char *> *mgnames, bool include_hidden)
378 for (u32 i = 0; i != ARRLEN(g_reg_mapgens); i++) {
379 if (include_hidden || g_reg_mapgens[i].is_user_visible)
380 mgnames->push_back(g_reg_mapgens[i].name);
385 MapgenFactory *EmergeManager::getMapgenFactory(const std::string &mgname)
387 for (u32 i = 0; i != ARRLEN(g_reg_mapgens); i++) {
388 if (mgname == g_reg_mapgens[i].name)
389 return g_reg_mapgens[i].factory;
396 bool EmergeManager::pushBlockEmergeData(
400 EmergeCompletionCallback callback,
401 void *callback_param,
402 bool *entry_already_exists)
404 u16 &count_peer = m_peer_queue_count[peer_requested];
406 if ((flags & BLOCK_EMERGE_FORCE_QUEUE) == 0) {
407 if (m_blocks_enqueued.size() >= m_qlimit_total)
410 if (peer_requested != PEER_ID_INEXISTENT) {
411 u16 qlimit_peer = (flags & BLOCK_EMERGE_ALLOW_GEN) ?
412 m_qlimit_generate : m_qlimit_diskonly;
413 if (count_peer >= qlimit_peer)
418 std::pair<std::map<v3s16, BlockEmergeData>::iterator, bool> findres;
419 findres = m_blocks_enqueued.insert(std::make_pair(pos, BlockEmergeData()));
421 BlockEmergeData &bedata = findres.first->second;
422 *entry_already_exists = !findres.second;
425 bedata.callbacks.push_back(std::make_pair(callback, callback_param));
427 if (*entry_already_exists) {
428 bedata.flags |= flags;
430 bedata.flags = flags;
431 bedata.peer_requested = peer_requested;
440 bool EmergeManager::popBlockEmergeData(
442 BlockEmergeData *bedata)
444 std::map<v3s16, BlockEmergeData>::iterator it;
445 std::map<u16, u16>::iterator it2;
447 it = m_blocks_enqueued.find(pos);
448 if (it == m_blocks_enqueued.end())
451 *bedata = it->second;
453 it2 = m_peer_queue_count.find(bedata->peer_requested);
454 if (it2 == m_peer_queue_count.end())
457 u16 &count_peer = it2->second;
458 assert(count_peer != 0);
461 m_blocks_enqueued.erase(it);
467 EmergeThread *EmergeManager::getOptimalThread()
469 size_t nthreads = m_threads.size();
471 FATAL_ERROR_IF(nthreads == 0, "No emerge threads!");
474 size_t nitems_lowest = m_threads[0]->m_block_queue.size();
476 for (size_t i = 1; i < nthreads; i++) {
477 size_t nitems = m_threads[i]->m_block_queue.size();
478 if (nitems < nitems_lowest) {
480 nitems_lowest = nitems;
484 return m_threads[index];
492 EmergeThread::EmergeThread(Server *server, int ethreadid) :
493 enable_mapgen_debug_info(false),
500 m_name = "Emerge-" + itos(ethreadid);
504 EmergeThread::~EmergeThread()
506 //cancelPendingItems();
510 void EmergeThread::signal()
512 m_queue_event.signal();
516 bool EmergeThread::pushBlock(v3s16 pos)
518 m_block_queue.push(pos);
523 void EmergeThread::cancelPendingItems()
525 MutexAutoLock queuelock(m_emerge->m_queue_mutex);
527 while (!m_block_queue.empty()) {
528 BlockEmergeData bedata;
531 pos = m_block_queue.front();
534 m_emerge->popBlockEmergeData(pos, &bedata);
536 runCompletionCallbacks(pos, EMERGE_CANCELLED, bedata.callbacks);
541 void EmergeThread::runCompletionCallbacks(
544 const EmergeCallbackList &callbacks)
546 for (size_t i = 0; i != callbacks.size(); i++) {
547 EmergeCompletionCallback callback;
550 callback = callbacks[i].first;
551 param = callbacks[i].second;
553 callback(pos, action, param);
558 bool EmergeThread::popBlockEmerge(v3s16 *pos, BlockEmergeData *bedata)
560 MutexAutoLock queuelock(m_emerge->m_queue_mutex);
562 if (m_block_queue.empty())
565 *pos = m_block_queue.front();
568 m_emerge->popBlockEmergeData(*pos, bedata);
574 EmergeAction EmergeThread::getBlockOrStartGen(
575 v3s16 pos, bool allow_gen, MapBlock **block, BlockMakeData *bmdata)
577 MutexAutoLock envlock(m_server->m_env_mutex);
579 // 1). Attempt to fetch block from memory
580 *block = m_map->getBlockNoCreateNoEx(pos);
581 if (*block && !(*block)->isDummy() && (*block)->isGenerated())
582 return EMERGE_FROM_MEMORY;
584 // 2). Attempt to load block from disk
585 *block = m_map->loadBlock(pos);
586 if (*block && (*block)->isGenerated())
587 return EMERGE_FROM_DISK;
589 // 3). Attempt to start generation
590 if (allow_gen && m_map->initBlockMake(pos, bmdata))
591 return EMERGE_GENERATED;
593 // All attempts failed; cancel this block emerge
594 return EMERGE_CANCELLED;
598 MapBlock *EmergeThread::finishGen(v3s16 pos, BlockMakeData *bmdata,
599 std::map<v3s16, MapBlock *> *modified_blocks)
601 MutexAutoLock envlock(m_server->m_env_mutex);
602 ScopeProfiler sp(g_profiler,
603 "EmergeThread: after Mapgen::makeChunk", SPT_AVG);
606 Perform post-processing on blocks (invalidate lighting, queue liquid
607 transforms, etc.) to finish block make
609 m_map->finishBlockMake(bmdata, modified_blocks);
611 MapBlock *block = m_map->getBlockNoCreateNoEx(pos);
613 errorstream << "EmergeThread::finishGen: Couldn't grab block we "
614 "just generated: " << PP(pos) << std::endl;
618 v3s16 minp = bmdata->blockpos_min * MAP_BLOCKSIZE;
619 v3s16 maxp = bmdata->blockpos_max * MAP_BLOCKSIZE +
620 v3s16(1,1,1) * (MAP_BLOCKSIZE - 1);
622 // Ignore map edit events, they will not need to be sent
623 // to anybody because the block hasn't been sent to anybody
624 MapEditEventAreaIgnorer ign(
625 &m_server->m_ignore_map_edit_events_area,
626 VoxelArea(minp, maxp));
629 Run Lua on_generated callbacks
632 m_server->getScriptIface()->environment_OnGenerated(
633 minp, maxp, m_mapgen->blockseed);
634 } catch (LuaError &e) {
635 m_server->setAsyncFatalError("Lua: " + std::string(e.what()));
638 EMERGE_DBG_OUT("ended up with: " << analyze_block(block));
643 m_server->m_env->activateBlock(block, 0);
649 void *EmergeThread::run()
651 DSTACK(FUNCTION_NAME);
652 BEGIN_DEBUG_EXCEPTION_HANDLER
656 m_map = (ServerMap *)&(m_server->m_env->getMap());
657 m_emerge = m_server->m_emerge;
658 m_mapgen = m_emerge->m_mapgens[id];
659 enable_mapgen_debug_info = m_emerge->enable_mapgen_debug_info;
662 while (!stopRequested()) {
663 std::map<v3s16, MapBlock *> modified_blocks;
664 BlockEmergeData bedata;
665 BlockMakeData bmdata;
669 if (!popBlockEmerge(&pos, &bedata)) {
670 m_queue_event.wait();
674 if (blockpos_over_limit(pos))
677 bool allow_gen = bedata.flags & BLOCK_EMERGE_ALLOW_GEN;
678 EMERGE_DBG_OUT("pos=" PP(pos) " allow_gen=" << allow_gen);
680 action = getBlockOrStartGen(pos, allow_gen, &block, &bmdata);
681 if (action == EMERGE_GENERATED) {
683 ScopeProfiler sp(g_profiler,
684 "EmergeThread: Mapgen::makeChunk", SPT_AVG);
685 TimeTaker t("mapgen::make_block()");
687 m_mapgen->makeChunk(&bmdata);
689 if (enable_mapgen_debug_info == false)
690 t.stop(true); // Hide output
693 block = finishGen(pos, &bmdata, &modified_blocks);
696 runCompletionCallbacks(pos, action, bedata.callbacks);
699 modified_blocks[pos] = block;
701 if (modified_blocks.size() > 0)
702 m_server->SetBlocksNotSent(modified_blocks);
704 } catch (VersionMismatchException &e) {
705 std::ostringstream err;
706 err << "World data version mismatch in MapBlock " << PP(pos) << std::endl
707 << "----" << std::endl
708 << "\"" << e.what() << "\"" << std::endl
709 << "See debug.txt." << std::endl
710 << "World probably saved by a newer version of " PROJECT_NAME_C "."
712 m_server->setAsyncFatalError(err.str());
713 } catch (SerializationError &e) {
714 std::ostringstream err;
715 err << "Invalid data in MapBlock " << PP(pos) << std::endl
716 << "----" << std::endl
717 << "\"" << e.what() << "\"" << std::endl
718 << "See debug.txt." << std::endl
719 << "You can ignore this using [ignore_world_load_errors = true]."
721 m_server->setAsyncFatalError(err.str());
724 END_DEBUG_EXCEPTION_HANDLER